SuperAPI AI 工具集

speckit-constitution

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:这是一个 SpecKit 工作流技能,负责创建或更新项目章程文件 .specify/memory/constitution.md。该文件是含方括号占位符(如 [PROJECT_NAME]、[PRINCIPLE_1_NAME])的模板,技能的目标是收集或推导具体取值、精确填充模板,并把修订传播到依赖产物。

主要能力:执行前检查项目根目录的 .specify/extensions.yml,读取 hooks.before_constitution,过滤 enabled 为 false 的项,对无条件字段的钩子视为可执行;命令名中的点号替换为连字符(如 speckit.git.commit → /speckit-git-commit)。可选钩子仅提示执行方式,强制钩子需实际调用并等待结果后再继续。核心流程为:加载现有章程、识别全部 [ALL_CAPS_IDENTIFIER] 占位符、按用户输入或仓库上下文(README、docs、历史章程版本)推导取值、按语义化版本规则递增 CONSTITUTION_VERSION(MAJOR 为不兼容的治理或原则移除/重定义,MINOR 为新增原则或章节,PATCH 为澄清与措辞修正),最后写回文件并覆盖。

一致性传播:需检查 .specify/templates/plan-template.md、spec-template.md、tasks-template.md、.specify/templates/commands/*.md 以及 README、docs/quickstart.md 等运行时指引,消除过时引用。写作时在章程顶部以 HTML 注释形式生成 Sync Impact Report,列出版本变更、修改原则、增删章节、需更新模板及遗留 TODO。

限制:不得新建模板,始终操作已有的 .specify/memory/constitution.md;若该文件缺失,应先用 .specify/templates/constitution-template.md 初始化。日期使用 ISO 格式 YYYY-MM-DD,RATIFICATION_DATE 未知时需询问或标记 TODO。若 .specify/extensions.yml 无法解析或不存在,静默跳过钩子检查。执行后还需检查 hooks.after_constitution 并输出摘要,包括新版本与递增理由、需人工跟进的文件及建议提交信息。