SuperAPI AI 工具集

speckit-constitution-zh

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

用途:维护位于 .specify/memory/constitution.md 的项目章程,该文件源自 assets/constitution-template.md,模板中以 [项目名称]、[原则_1_名称] 等方括号占位符标记待填内容。技能负责收集或推导具体值、填充模板,并把修订传播到依赖工件。

主要能力:把 assets/specify/ 下所有文件(含子目录)按原结构复制到仓库根目录的 .specify,跳过已有文件且不覆盖同名文件(可用 cp 的 -n/--no-clobber);复制后目录含 memory、scripts(bash 与 powershell 两套脚本)、specs、templates 等。随后加载现有章程模板,识别所有 [ALL_CAPS_IDENTIFIER] 占位符;占位符数量可按用户指定增减。用户输入有值则采用,否则从 README、文档、旧版章程等仓库上下文推断。

版本与日期:批准日期为原始采用日期,未知则询问或标 TODO;有改动则最后修订日期为当天。章程版本按语义化规则递增:主版本用于不兼容的治理或原则删除/重定义,次版本用于新增原则或章节、实质性扩展,补丁用于澄清、措辞与错别字修正。升级类型不明确时需在定稿前说明理由。

同步与验证:读取 plan-template.md、spec-template.md、tasks-template.md 及 README、docs/quickstart.md 等运行时指导文档,更新与变更原则相关的“章程检查”、范围、约束与任务分类;在章程顶部以 HTML 注释生成同步影响报告,包含版本变更、修改/新增/删除章节、需更新模板及待办。最终校验无未解释的括号令牌、版本行与报告一致、日期为 ISO 格式 YYYY-MM-DD、原则陈述可测试且避免模糊措辞。写回 constitution.md 后输出新版本与升级理由、待人工跟进文件及建议提交信息。

限制:不创建新模板,始终操作现有 .specify/memory/constitution.md;关键信息缺失时插入 TODO 并列入延期项;需保持模板 Markdown 标题层级、章节间空行,避免尾随空白。适用场景为项目管理、规范制定、章程维护与团队协作。平台与费用等未在资料中提供。