legacy-archaeologylisted

# legacy-archaeology（老代码考古） > 把一个黑盒老项目反推成「树形下钻、业务/库/接口讲清」的知识库，给后续重构的 AI 做背景注入。 > **承诺只到「边界内可审计覆盖 + 残余风险显式登记」——不吹「我没漏」，只保证「我已识别的盲区、未证实项、未获取的真值源都显式登记了」。** 这个 skill 是一个**编排器**，不是文档生成器。它指挥主 agent 粗扫、切块、派出 agent team 逐模块调查，把结果汇聚成一棵 README 层层索引的知识库树。一个项目一棵树，多个项目共享一个 平台层调用图。重构 AI 平时只读 L1，要哪块钉哪块往下读：省上下文，又能审计到每一处盲区。 --- ## §1 干什么 / 不干什么（边界） ### 1.1 只产三层，不碰其余 - **产出**：业务逻辑 / 数据库 / 接口。这三层讲清楚，足够给重构 AI 注入背景。 - **不碰**：需求文档、代码实现细节、测试。它们要么是重构后才重写的（需求），要么是被替换掉的 （代码、测试）。把它们写进来只会增重、过期、抢上下文。 - **不描述代码**：讲的是「系统做什么决策、存什么数据、暴露什么契约」，不是「类怎么继承、方法怎么调」。 描述代码 = 把旧包袱原样搬进新系统。 ### 1.2 读者是 AI，不是人 - 风格**索引重、表格化、叙事轻**。每个目录一个 README 当导航节点，逐层下钻。 - 不写给人读的连贯散文；写给 AI 检索：标题密、锚点全、状态标注清楚。 ### 1.3 一次性快照 - 老项目不再大改、不会继续腐烂，所以**不设防过期机制**。这是某一时刻的考古快照，带「快照批次号」。 - 推论：不必为「文档与代码持续同步」付出任何设计成本——那是 doc-layer-system 的活，不是这里的活。 ### 1.4 承诺口径（地基，全文不得违反） > **本 skill 不承诺「业务逻辑零遗漏」。** 白盒静态扫描无法证明「我枚举出来的 = 系统里全部」， > 把无法证明的东西写成承诺就是自欺。 > > 本 skill 承诺的是：**① 边界内可审计覆盖**（写下来的每条都有源码锚点、可回查）； > **② 残余风险显式登记**（没覆盖到的、没证实的、失传的，全部明确列出来，不藏）。 > > 任何产物、任何对账，**禁止出现「已查全 / 零遗漏 / 完整」字样**。只能说「在已知枚举边界内已覆盖， > 未覆盖部分见残余风险清单」。 ### 1.5 与其他 skill 的边界 本 skill 与 `code-to-guide`、`code-to-7layer` 机制有重叠，但定位不同。逐机制区别见 `references/与现有skill边界对照.md`。一句话：**本 skill 只产「重构背景知识索引」，不产需求结论、 不产七层正式真值**；能复用的已验证机制（fan-out、证据分级、硬暂停）尽量复用，不另造轮子。 --- ## §2 产出落点 & 路径命名规范（索引承重墙） **这个 skill 的路径就是索引本身。** 重构 AI「读 L1 → 钉下去」靠的全是各层 README 里的下钻链接， 链接就是相对路径。命名不钉死 → 增量建库（一次一个项目、跨多次运行）时结构漂移、导航断链。 所以路径规范是硬约束，不是建议。 ### 2.1 固定骨架（雷打不动） ``` <知识库根>/ README.md ← 平台总览（导航总入