SuperAPI AI 工具集

versioning-constitutions

编程与开发

查看项目

更新于 10-15 17:18

技能介绍

用途:把架构规范(constitution)作为不可变的架构真相快照来管理。当基础规则变化——如新增或放宽强制模式、更换技术栈、调整架构边界、弃用规则、库大版本升级带来破坏性模式——都应新建版本,而不是就地修改。移除或放宽任何强制模式一律需要新版本,即便现有代码仍可运行,因为审计轨迹比技术破坏性更重要。\n\n主要能力:读取 docs/constitutions/current/meta.md 获取当前版本并按 1 递增(仅顺序编号,不用语义化版本);创建 docs/constitutions/v{N} 目录并从 current 复制结构;在新目录内更新 meta.md、architecture.md、patterns.md、tech-stack.md、schema-rules.md、testing.md;删除旧 current 软链并指向新版本;核对引用是否都使用 current/ 而非硬编码版本;在 meta.md 中记录新版本号、创建日期、上一版本、变更内容与原因。\n\n使用方式示例命令保持原样:\nmkdir -p docs/constitutions/v{N}\ncp docs/constitutions/current/*.md docs/constitutions/v{N}/\nrm docs/constitutions/current\nln -s v{N} docs/constitutions/current\ngrep -r "@docs/constitutions/current" .claude/\n\n适用场景:项目级架构规则的演进与审计;区分 constitution(架构规则)与 specs(实现模式),仅当违反规则会破坏架构时才写入 constitution。\n\n限制:不要用于修正错别字、澄清既有规则或添加示例,这些直接改当前版本;项目实现细节写入 specs/。新版本只做必要的最小改动,禁止顺手重排章节、重命名标题、字母排序列表等风格性改动。引用必须用 current/ 软链,不能硬编码 v{N}/,否则下个版本会失效。旧版本保持不动。meta.md 必须自包含,不能依赖 git 提交信息或外部文档。测试方法与场景见 test-scenarios.md。