祖传代码考古学家

先解决接手时的具体问题

刚拿到一个没有文档的老仓库，困难不是看不懂单个函数，而是不知道入口在哪、配置如何生效、请求经过哪些模块、哪些改动会触发连锁反应。本技能把这种接手拆成可重复执行的考古过程：先用 Explore 子代理找 main、入口文件、构建脚本和配置文件；再盘点语言、框架、依赖版本，标记 EOL 依赖；随后追 1–2 条核心业务链路，从请求到处理到存储，并把调用关系画出来。输出不止是解释，而是后续能照着行动的材料。

核心能力和关键步骤

• 入口定位：识别仓库启动点、构建脚本和关键配置，避免从目录名猜测系统结构。
• 技术栈与依赖健康度：列出语言、框架、依赖版本，指出已停止维护的项。
• 数据流测绘：追踪核心业务链路，输出请求到处理再到存储的调用链图。
• 雷区标记：扫描全局状态、隐式耦合、魔法数字、重复代码、超长函数、无测试模块和硬编码密钥，按 🔴🟡🟢 分级。
• 新人上手手册：整理本地运行步骤、目录导览、关键调用链，以及“改 X 先看 Y”清单。
• 改造路线：按绞杀者模式给出分阶段建议，每阶段独立可回滚，而不是一次性推倒。

最终交付《考古报告》，可以是 Markdown 或 HTML，并附架构调用链图。报告固定包含：①项目一句话画像 ②技术栈与依赖健康度 ③核心调用链图 ④雷区地图 ⑤新人上手手册 ⑥安全改造路线。示例输出会写清楚风险与动作，比如“utils.py 2800 行且无测试，任何修改先补黄金用例再动”。

适用边界与注意点

它适合刚接手老项目、需要先建立系统地图再动代码的开发者。技能不会未经确认就大规模改写代码，也不主张轻易推倒重写；是否重构需要基于调用链、测试覆盖和风险分级论证。硬编码密钥只提示位置，不在报告中展示明文。报告用于降低认知成本和改造风险，最终改法仍应由人确认。