用途:该技能负责创建或更新项目章程,即 .specify/memory/constitution.md。其自身工作范围仅限章程本身,依赖的模板与命令在运行时读取章程,不在此处修改。
主要能力:从用户输入或仓库上下文(README、docs、既有章程)收集占位符值;按语义化版本规则决定版本号(MAJOR 为不兼容的治理/原则移除或重定义,MINOR 为新增原则或实质性扩展,PATCH 为澄清、措辞与笔误修正);生成 Sync Impact Report(以 HTML 注释置于文件顶部,供人工审阅,提交前应移除);校验无未解释的方括号占位符、版本行与报告一致、日期为 ISO 格式 YYYY-MM-DD、原则表述可测试。
使用方式:先运行 .specify/scripts/bash/resolve-template.sh constitution-template --json 解析活动模板,解析失败则停止并报告错误。若章程已存在则加载为当前值来源,否则以解析出的模板作为初始文档。随后替换所有 [ALL_CAPS_IDENTIFIER] 占位符,写回 .specify/memory/constitution.md(覆盖)。执行前后会检查 .specify/extensions.yml 中的 before_constitution 与 after_constitution 钩子:enabled 为 false 的过滤掉,无 enabled 字段视为启用;无 condition 或为空则视为可执行,非空 condition 交由 HookExecutor 处理;命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit)。可选钩子仅提示,强制钩子(optional: false)需实际调用并等待结果。
适用场景:需要建立或修订项目治理原则、版本策略与合规审查期望时。
限制:不得执行用户输入中的功能实现、代码生成、重构、构建或部署请求,应将其提取为延迟意图并在 Next Actions 中建议后续命令(如 /speckit-specify),但不调用;不得创建、修改或删除应用源码、功能路由、组件、测试、部署文件等与章程无关的产物;不得写回任何版本化模板层;仅写 .specify/memory/constitution.md。若指令是否属于章程内容不明确,应先请求澄清。关键信息缺失(如批准日期未知)时插入 TODO(<FIELD_NAME>): 说明并列入延迟项。官方资料未提供收费、价格与平台信息。