SuperAPI AI 工具集

change-boot

编程与开发

查看项目

更新于 10-16 01:12

技能介绍

用途:change-boot 属于 team-boot 的 Class Boots 目录中的五个 class boot 之一。team-boot 在会话开始时注入团队上下文(constitution、CDR 索引、skills registry),本技能则按需加载变更历史层——从 git 历史挖掘并发布的 ChDR 索引,并与决策捕获配对,使变更理由通过 /change-init 被恢复,而不是只存在于提交信息中。读取过往理由与记录新理由构成同一循环。

使用时机:应在匹配任务开始时、规划待办列表与实现之前调用,绝不要推迟到会话结束。适用情形包括:重构或修改不熟悉的代码前,先查看是否有 ChDR 解释当前形态;分析 revert、hotfix 或修复链;会话以人工撰写的消息产生 git 变更(commit/merge/revert/rebase/cherry-pick/tag、人工撰写的 PR 标题或正文、CHANGELOG 编辑)时,在会话结束时评估理由是否足够非显而易见而值得生成 ChDR;会话产生变更理由(revert/hotfix 说明,或链接到 issue tracker 的提交)。

核心流程:第一步定位 ChDR 索引,从当前工作目录(不要向上遍历父目录)查找 docs/adlc/memory/chdr.md,回退为 .adlc/memory/chdr.md;若索引缺失但存在 ChDR-*.md 文件,则从各文件合成精简表格;若什么都不存在,报告 0 ChDRs,绝不编造行。当当前目录位于工作区内(通过祖先目录的 .gitmodules 标记检测)且无本地索引时,改读工作区根目录的 docs/adlc/memory/ 索引。第一步 b 读取 .adlc/drafts/chdr/ 中状态为 proposed 或 discovered 的草稿。第二步按输出契约注入 ChDR Context 表格与 Drafts Pending Review 表格,并给出 Searched N ChDRs, K matched. 计数行,K 必须等于所示表格行数,0 行匹配时只输出标题与计数行。第三步捕获变更理由,按触发条件将 ChDR 直接写入 .adlc/drafts/chdr/,并在 Team Context & Decisions 中新增或刷新行。

限制与失败处理:索引与记录均缺失时只输出标题与 Searched 0 ChDRs, 0 matched.,不阻塞任务;无法解析的索引行跳过并记录跳过数。红旗包括编造 ChDR 行、夸大 K、注入索引却忽略捕获、向上遍历父目录查找 .adlc/、挖掘理由时缺少 SHA/URL 溯源。验证要求 ChDR Context 表格与计数行一致,且检测到的 ChDR 类决策已加入 Team Context & Decisions 行。