用途:在项目启动阶段建立或更新项目宪法(治理原则与开发规范),用于明确代码质量、测试标准与架构约束。核心操作对象是 .specify/memory/constitution.md;若该文件不存在,应先从 .specify/templates/constitution-template.md 复制模板初始化。
主要能力:识别模板中形如 [ALL_CAPS_IDENTIFIER] 的占位符;从用户输入或仓库上下文(README、docs、历史版本)推导取值;按语义化版本规则递增版本(MAJOR 不兼容的治理/原则删除或重定义,MINOR 新增或实质性扩展,PATCH 澄清与措辞修正);起草更新后的宪法内容,替换占位符,保留标题层级,原则需可声明、可测试。
一致性同步:需核对 .specify/templates/plan-template.md 中的 Constitution Check,spec-template.md 的范围与需求,tasks-template.md 的任务分类,以及 .specify/templates/commands/*.md 和其他运行时说明文档中的原则引用,并生成 Sync Impact Report(以 HTML 注释置于文件顶部),列出版本变更、修改/新增/删除的原则与章节、待更新模板及后续 TODO。
使用与限制:写入前须验证无未解释的方括号占位符、版本行与报告一致、日期为 ISO 格式 YYYY-MM-DD。缺失关键信息(如批准日期未知)时插入 TODO 并列入延迟项。最终向用户输出新版本与递增理由、需人工跟进的文件及建议提交信息。不得创建新模板,始终操作现有宪法文件。