用途:在 Cavekit 中,revision 指把生产缺陷沿 cavekit 链路向上追溯,找到允许该缺陷出现的缺口,并在 kits 与 prompts 源头修复,而不只是改代码。核心观点是:若修复只存在于代码、没有对应的 cavekit 更新,下一轮迭代循环可能重新引入同一缺陷;目标是让 kits 加迭代循环能自主复现任何修复。
主要能力:提供 6 步修订流程——识别并修复缺陷、分析 cavekit 遗漏了什么(WHAT/WHY/VISUAL/RULE/LAYER 五个维度)、更新 cavekit、把变更传播到 plans 与 impl 跟踪、在检测到模式时做系统性 prompt 改进、验证并锁定(移除手工修复后重跑迭代循环,再生成回归测试)。还包含自动化修订分析:按 manual fix、iteration loop、infrastructure 分类提交,分析每个手工修复,发现受影响的 plan 文件,更新上下文文件,运行测试并生成回归测试。
使用方式:资料给出若干命令示例,如 git log --oneline -5、iteration-loop context/prompts/003-generate-impl-from-plans.md -n 5 -t 1h、{TEST_COMMAND} --cavekit context/kits/cavekit-data.md、{BUILD_COMMAND}、{TEST_COMMAND}。单失败反向传播协议在 /ck:make 测试失败时自动触发,或手动执行 /ck:revise --trace,按 TRACE、ANALYZE、PROPOSE、GENERATE、VERIFY、LOG 六步进行,其中 PROPOSE 需用户明确批准后才写入 kit,日志追加到 .cavekit/history/backprop-log.md。
适用场景:手工修复后需回填 kits;同一类缺陷反复出现;需要提升迭代收敛性;用 /ck:review --mode gap 主动发现修订目标。
限制:并非所有代码修复都需要修订,一次性环境问题、拼写与格式、原型探索性改动、不改变行为的性能优化通常跳过;判定标准是迭代循环是否可能重新引入该缺陷。资料未提供具体收费、平台与效果数据。