tangweijie
aba7071723
将项目约束正式落到 .specify/memory/constitution.md，并同步更新 plan、spec、tasks、checklist、agent 模板，使 Speckit 工作流默认遵循文档单一真源、范围收敛、Archive 隔离与校验闭环。
78 lines
3.4 KiB
Markdown
78 lines
3.4 KiB
Markdown
# Implementation Plan: [FEATURE]
|
||
|
||
**Branch**: `[###-feature-name]` | **Date**: [DATE] | **Spec**: [link]
|
||
**Input**: Feature specification from `/specs/[###-feature-name]/spec.md`
|
||
|
||
**Note**: This template is filled in by the `/speckit.plan` command. See `.specify/templates/plan-template.md` for the execution workflow.
|
||
|
||
## Summary
|
||
|
||
[Extract from feature spec: primary requirement + target documents + intended update approach]
|
||
|
||
## Technical Context
|
||
|
||
<!--
|
||
ACTION REQUIRED: Replace this section with the real project context.
|
||
For this repository, prefer documenting document-system context rather than
|
||
inventing software implementation context.
|
||
-->
|
||
|
||
**Primary Work Product**: [e.g., Markdown design docs, management docs, link/index governance or NEEDS CLARIFICATION]
|
||
**Source of Truth Documents**: [List the authoritative docs that this change must align with]
|
||
**Reference Sources**: [Archive/guides/other references allowed for verification]
|
||
**Validation Commands**: [e.g., make validate-file FILE=..., make check-links, make validate-mermaid]
|
||
**Target Scope**: [e.g., specific chapters, specific main docs, cross-doc governance]
|
||
**Project Type**: 文档治理仓库
|
||
**Constraints**: [e.g., no new parallel formal docs, no invented business rules, relative links only]
|
||
**Scale/Scope**: [e.g., single document / cross-document / structural governance]
|
||
|
||
## Constitution Check
|
||
|
||
*GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.*
|
||
|
||
- [ ] **主文档归属已确认**：本次改动将优先落在既有主文档或治理文档，而不是新增平行正式稿。
|
||
- [ ] **范围基线已确认**：若涉及新增功能、模块、接口或外部协同，已按 `03_Summary_Design.md` 与 Archive 范围基线交集完成判定。
|
||
- [ ] **Archive 使用方式合规**：Archive 仅作为来源/核对输入，不直接替代正式口径。
|
||
- [ ] **一致性影响已列出**：已识别系统名称、数据库口径、编号、图表、链接、术语等受影响项。
|
||
- [ ] **校验与台账动作已规划**：已明确需要执行的校验命令，以及是否需要更新 `01_Project_Progress.md` / `03_Task_Checklist.md`。
|
||
|
||
## Project Structure
|
||
|
||
### Documentation (this feature)
|
||
|
||
```text
|
||
specs/[###-feature]/
|
||
├── plan.md # This file (/speckit.plan command output)
|
||
├── research.md # Phase 0 output (/speckit.plan command)
|
||
├── data-model.md # Optional: document entities/traceability objects
|
||
├── quickstart.md # Optional: validation or review quickstart
|
||
├── contracts/ # Optional: interface or section-level artifacts
|
||
└── tasks.md # Phase 2 output (/speckit.tasks command)
|
||
```
|
||
|
||
### Repository Touchpoints
|
||
|
||
```text
|
||
docs/design/
|
||
├── 00_Management/
|
||
├── 01_Overview/
|
||
├── 02_Detailed_Design/
|
||
├── 03_Technical_Design/
|
||
└── 04_Appendix/Archive/
|
||
|
||
README.md
|
||
AGENTS.md
|
||
.specify/templates/
|
||
```
|
||
|
||
**Structure Decision**: [Document the exact files to be updated and the reason each file is in scope]
|
||
|
||
## Complexity Tracking
|
||
|
||
> **Fill ONLY if Constitution Check has violations that must be justified**
|
||
|
||
| Violation | Why Needed | Simpler Alternative Rejected Because |
|
||
|-----------|------------|-------------------------------------|
|
||
| [e.g., temporary appendix doc] | [current need] | [why existing main doc could not safely absorb it] |
|
||
| [e.g., Archive citation exception] | [specific traceability reason] | [why normal main-doc source was insufficient] |
|