SuperAPI AI 工具集

speckit-constitution

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:在项目初始化或治理原则需要更新时,维护项目章程文件 .specify/memory/constitution.md。若项目尚未运行 specify init,需先用 speckit-install 安装 CLI,再用 speckit-initial 初始化项目。

主要能力:读取现有章程模板,识别形如 [ALL_CAPS_IDENTIFIER] 的占位符(如 [PROJECT_NAME]、[PRINCIPLE_1_NAME]),从用户输入或仓库上下文(README、docs、旧版章程)推导具体值并精确填充;按语义化版本规则递增 CONSTITUTION_VERSION(MAJOR 为不兼容的治理/原则删除或重定义,MINOR 为新增原则或章节,PATCH 为澄清与措辞修正);治理日期中 RATIFICATION_DATE 为原始通过日期,LAST_AMENDED_DATE 在有改动时取当天。

一致性传播:检查并更新 .specify/templates/plan-template.md、spec-template.md、tasks-template.md,以及 .claude/commands/speckit..md、.codex/prompts/speckit..md、.gemini/commands/speckit..toml、.github/prompts/speckit..prompt.md、.github/agents/speckit..agent.md、skills/speckit-/SKILL.md 等运行时提示与代理文件,并在章程顶部以 HTML 注释形式生成 Sync Impact Report(版本变化、原则增删改、待更新模板、遗留 TODO)。

输出与限制:覆盖写回 .specify/memory/constitution.md,并向用户给出新版本与递增理由、需人工跟进的文件、建议提交信息。校验要求包括无未解释的方括号占位符、版本行与报告一致、日期为 YYYY-MM-DD、原则表述可测试。关键信息缺失时插入 TODO(<FIELD_NAME>) 并列入报告;不新建模板,始终操作现有章程文件。后续可用 speckit-specify 编写新功能规格。