SuperAPI AI 工具集

spec-kit-constitution

通用与其它

查看项目

更新于 10-16 05:02

技能介绍

用途:创建或修订 Spec Kit 项目的章程(治理与原则),并保持依赖模板一致。当用户要求为 Spec Kit 项目创建首个章程、修订治理/原则并更新版本,或 memory/constitution.md 缺失、仍含 [PLACEHOLDER] 占位符,或原则变更需传播到规划/规格/任务模板时使用。调用时需按名称告知用户正在使用 spec-kit-constitution。

主要能力:解析章程文件(目标为 {REPO_ROOT}/memory/constitution.md,缺失时从 templates/constitution-template.md 或 assets/constitution-template.md 初始化);采集现有章程基线(版本、批准与最后修订日期、原则/章节标题、未解决占位符);按语义化版本决定 MAJOR/MINOR/PATCH 与日期;起草章程,将占位符替换为具体政策文本,保持模板标题层级,原则需可声明、可测试(MUST/SHOULD 并附理由),治理部分明确修订流程、版本策略与合规审查;将政策变更传播到 templates/plan-template.md、templates/spec-template.md、templates/tasks-template.md;在 memory/constitution.md 前置 Sync Impact Report HTML 注释,含版本变更、修改原则、增删章节、模板同步状态与待办 TODO;最终校验无未解释占位符、版本/日期行与报告一致且为 YYYY-MM-DD、路径为 memory/constitution.md。

使用方式:在目标项目仓库根目录操作;先由用户输入填充必需值,再用仓库上下文补充;关键数据未知时使用 TODO(<FIELD_NAME>): <reason>。输出更新后的 memory/constitution.md、必要的模板文件,以及含版本升级理由、待跟进项和建议提交信息的摘要。

适用场景:Spec Kit 项目治理/原则相关意图的主路由;宪法规则变更后、功能规划前运行;下游 spec-kit-plan 的章程检查依赖此输出。

限制与常见错误:原则更新后未同步依赖模板;对重大政策变更误用 PATCH 升级;遗留未解决占位符且无 TODO 标注;误写为 /memory/constitution.md。参考资料包括 references/spec-kit-workflow.dot、assets 下各模板及 GitHub spec-kit 的 constitution 命令文档。