SuperAPI AI 工具集

speckit-constitution

编程与开发

查看项目

更新于 10-24 10:10

技能介绍

用途

speckit-constitution 是一个面向 Spec Kit 类项目的技能,负责维护项目宪法文件 .specify/memory/constitution.md。该文件以模板形式存在,包含形如 [PROJECT_NAME]、[PRINCIPLE_1_NAME] 的占位符。技能的核心任务是将这些占位符替换为具体内容,并使宪法版本与依赖产物保持同步。

主要能力

  • 读取现有宪法文件,识别所有 [ALL_CAPS_IDENTIFIER] 形式的占位符。
  • 根据用户输入或仓库上下文(README、文档、历史宪法版本)推导占位符取值。
  • 按语义化版本规则决定版本递增类型:MAJOR 表示不兼容的治理/原则移除或重定义,MINOR 表示新增原则/章节或实质性扩展,PATCH 表示澄清、措辞修正等非语义调整。
  • 确保原则章节包含简洁名称、不可协商的规则说明及必要理由;治理章节包含修订程序、版本策略与合规审查期望。
  • 更新后校验 .specify/templates/plan-template.md、spec-template.md、tasks-template.md、.specify/templates/commands/*.md 及运行时指引文档,使引用与新原则一致。
  • 在宪法文件顶部以 HTML 注释形式生成同步影响报告,列出版本变化、修改/新增/移除的原则与章节、需更新的模板状态及待办事项。
  • 执行前后检查 .specify/extensions.yml 中的 before_constitution 与 after_constitution 钩子,按 optional 标志输出或自动执行对应斜杠命令。

使用方式

该技能以斜杠命令形式调用,可接收 $ARGUMENTS 作为用户输入。执行流程为:先运行前置钩子检查,再加载宪法、收集取值、起草内容、传播一致性修改、生成同步影响报告、完成验证,最后将更新写回 .specify/memory/constitution.md 并输出摘要,包含新版本号与递增理由、需人工跟进的文件及建议的提交信息。

适用场景

适用于采用 Spec Kit 工作流、需要以宪法形式固化项目治理原则并保持多份模板同步的软件开发项目,尤其适合原则增删改后需要批量校验依赖文档一致性的场景。

限制

该技能依赖 .specify/memory/constitution.md 及配套模板存在;若宪法文件缺失,需先从 .specify/templates/constitution-template.md 复制。钩子条件表达式不做解释,交由 HookExecutor 处理。关键信息缺失时以 TODO(<FIELD_NAME>) 标记并列入同步影响报告。不创建新模板,始终操作现有宪法文件。