将项目约束正式落到 .specify/memory/constitution.md,并同步更新 plan、spec、tasks、checklist、agent 模板,使 Speckit 工作流默认遵循文档单一真源、范围收敛、Archive 隔离与校验闭环。
3.4 KiB
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
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)
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
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] |