用途:在项目规范流程中创建或更新项目宪章(constitution),把原则、治理规则和版本信息写入 .specify/memory/constitution.md,并同步受影响的模板与命令文件。
主要能力:读取现有宪章并识别所有 [ALL_CAPS_IDENTIFIER] 占位符;从用户输入或仓库上下文推导具体值;按语义化版本规则决定 MAJOR/MINOR/PATCH 版本号;在宪章顶部生成 Sync Impact Report;校验日期为 YYYY-MM-DD、原则可测试、无残留占位符;覆盖写回宪章文件;输出最终摘要(新版本、版本变更理由、需人工跟进的文件、建议提交信息)。
使用方式:执行前检查项目根目录 .specify/extensions.yml 的 hooks.before_constitution;若存在且可解析,按 enabled 过滤后逐个处理,条件非空的 hook 交给 HookExecutor 评估;命令名中的点替换为连字符,如 speckit.git.commit 对应 /speckit-git-commit。随后加载 .specify/memory/constitution.md,若缺失则先复制 .specify/templates/constitution-template.md。填充占位符并同步 plan-template.md、spec-template.md、tasks-template.md、.specify/templates/commands/*.md 及 README/docs 等运行时文档。更新后再次检查 hooks.after_constitution。
适用场景:需要为项目建立或修订治理原则、并让规划/规格/任务模板与之一致时使用。
限制:资料未提供收费、价格、平台支持或效果信息。若关键信息缺失(如批准日期未知),应写入 TODO(<FIELD_NAME>) 并在 Sync Impact Report 的 deferred 中列出;不得新建模板,始终操作现有宪章文件。