SuperAPI AI 工具集

cmd-speckit-constitution

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:该技能用于创建或更新项目章程,写入 .specify/memory/constitution.md。该文件是含方括号占位符(如 [PROJECT_NAME]、[PRINCIPLE_1_NAME])的模板,技能负责收集或推导具体取值、精确填充模板,并把修订传播到依赖产物。若文件尚不存在,应先从 .specify/templates/constitution-template.md 复制初始化。

主要能力:识别所有 [ALL_CAPS_IDENTIFIER] 占位符;按用户输入或仓库上下文(README、docs、历史章程)推导取值;按语义化版本规则决定版本号(MAJOR 为不兼容的治理/原则删除或重定义,MINOR 为新增原则或章节,PATCH 为澄清与措辞修正);生成 Sync Impact Report 并以 HTML 注释置于章程顶部;校验无遗留未解释占位符、版本行与报告一致、日期为 YYYY-MM-DD 格式、原则表述可测试。

使用方式:执行前检查项目根目录 .specify/extensions.yml 的 hooks.before_constitution,执行后检查 hooks.after_constitution;enabled 为 false 的跳过,无 condition 的视为可执行,有非空 condition 的留给 HookExecutor 处理。可选钩子仅提示执行命令,强制钩子需实际调用并等待结果。随后按执行流程加载章程、填充占位符、同步 plan-template.md、spec-template.md、tasks-template.md、.specify/templates/commands/*.md 及运行时文档,最后覆盖写回并输出摘要(新版本与升级理由、待人工跟进文件、建议提交信息)。

适用场景:需要为采用 Spec Kit 风格工作流的项目建立或修订治理原则、版本策略与合规审查要求时。

限制:不创建新模板,始终操作现有 constitution.md;缺失关键信息(如批准日期未知)时插入 TODO 并列入报告;具体命令调用形式可能因 agent 环境而异。