tangweijie aba7071723 docs: 建立项目宪法并同步 speckit 模板
将项目约束正式落到 .specify/memory/constitution.md,并同步更新 plan、spec、tasks、checklist、agent 模板,使 Speckit 工作流默认遵循文档单一真源、范围收敛、Archive 隔离与校验闭环。
2026-03-13 10:45:13 +08:00

3.4 KiB
Raw Blame History

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]