用途:把代码库中隐形的历史修补(bugfix、hotfix、workaround、防御模式)变得可读,保留组织记忆,避免后人重复踩坑。“金”指注释、ADR、测试标注、文档等上下文。
主要能力:按伤疤分类法识别八类痕迹(workaround、防御性守卫、魔法值、回归测试、依赖锁定、回退模式、静默迁移、配置覆盖);通过 git 考古扫描 fix、hotfix、patch、workaround、revert、fallback、incident、regression 等关键词,并 grep 代码模式;对每处伤疤按全金/半金/裸伤疤评级;生成按爆炸半径、腐化风险、混淆潜力打分的镀金待办(上限 10 项,每项可在一个小 PR 内完成);给出健康度评分(全金或半金占比,目标 80%+);并输出预防指南,评估提交规范、修复模板、事件链接、测试命名、锁定注释等实践是否到位。
使用方式:/kintsugi 扫描全库与近期 git 历史;/kintsugi "focus description" 可限定范围,如 "auth module"、"last 3 months of hotfixes"、"defensive null checks"、"dependency pins"。聚焦时先给焦点发现,其余标记 [ALSO NOTED]。默认 git 回溯 6 个月。按 D1 伤疤发现、D2 金级审计、D3 镀金待办、D4 健康度、D5 预防指南顺序执行。
适用场景:接手遗留代码、团队人员流动导致上下文流失、审查热修复与依赖锁定原因、盘点测试来源。
限制:只做文档补充,不改变行为,不重构、不改测试逻辑;低上下文注释(如 // fix)不算金;显而易见的守卫(如文件 IO 的 try/catch)不应镀金;重建故事需标注置信度与证据,不得臆测。具体平台、收费与安装方式暂未提供。