verify 是 agent-toolkit 中的维护技能,目标是缩小 CONTEXT.md 与所描述代码之间的差距,同时不静默重写硬性契约。
用途与能力:检测 CONTEXT.md 是否因代码变化而过期,识别带有测试引用的硬性接缝,并发现缺失的硬性接缝测试文件。核心是不对称处理:软性分歧表示代码变了,应以代码为准更新文档;硬性分歧不得静默改写,否则会把缺陷洗白成规范。
使用方式:技能自带 scripts/ 目录,需先设置 SKILL_DIR 为该技能目录的绝对路径,再从项目根目录运行。先用 node "$SKILL_DIR/scripts/context-discover.mjs" 发现上下文,再用 node "$SKILL_DIR/scripts/context-verify.mjs" --all [--run-tests] 运行漂移检测并解析 JSON 输出。随后按坚固度分诊:软性偏差自动更新;硬性偏差向用户呈现,让其选择有意变更(走 firm-change 协议)或回归缺陷(不改文档,标记为 bug)。处理后用 git rev-parse HEAD 重新盖章溯源,最后给出摘要并请用户确认。带 --ci 时输出 JSON 报告,退出码:0 无硬性失败,1 有硬性测试缺失或失败,2 仅过期。
适用场景:无需活动变更清单即可运行;若存在活动变更,其 architecture.md 与 decisions.md 可作为对照参考。
限制:不做代码实现改动;不运行 architect 或 specify;不保证运行后 CONTEXT.md 完全准确,仅尽力核对,遗留误差交由下次 verify 捕获。参考资料含 drift-control.md、firm-change-protocol.md、context-schema.md、seam-and-test-taxonomy.md。