前言¶

接手一段没人敢动的代码时，最常见的困境不是改不动，而是不知道它为什么是这样。文档缺失、注释过期、同一段逻辑散落在多个文件里，改任何一行都可能引爆线上问题。多数通用助手面对这类需求会先反问”你想做什么”，然后拿通用能力硬猜业务。下面介绍的这个 Skill 换了一种做法：先还原代码原本在干什么，再列隐患、给重构路径，不直接大改。

这是什么¶

「祖传代码考古学家 · 接手烂代码的第一救援」是一个社区发布的 Agent Skill，坐标 @user_8ee65e73/legacy-code-archaeologist，当前版本 1.1.4，分类 dev-programming，标签 requires_api_key=false（不需要额外配置 API key）。它解决的问题是：面对无文档、无注释、无作者的遗留系统，如何安全地完成一次”接手”——把代码背后的业务逻辑、依赖关系和潜在风险梳理清楚，并给出可回退的重构步骤。

核心能力¶

按官方简介，这个 Skill 的能力边界可以拆成两块。

一是还原。把祖传代码当”遗迹”来发掘：梳理现有逻辑的实际走向、代码之间的依赖关系，输出一份逻辑梳理结果。

二是救援。在梳理的基础上识别隐患（哪些地方容易在修改后出问题），并给出安全重构路径，交付物包括隐患清单、依赖关系、重构步骤和回退方案。

它明确不用于大规模自动重写。这是它和普通”帮我改代码”类 Skill 的关键区别：输出的是分析报告和分步计划，而不是直接替换后的新代码。

安装与启用¶

资料中未提供该 Skill 的具体安装命令、目录路径或配置文件字段，此处不做推测。需要启用时，请到官方地址获取安装方式：

https://api.skillhub.cn/user_8ee65e73/legacy-code-archaeologist

Skill 页面上提供了对应的 SkillHub 页面地址：

https://www.skillhub.cn/skills/user_8ee65e73/legacy-code-archaeologist

已知的配置信息：标签 requires_api_key=false，即启用时不需要填写 API key。该 Skill 基于通用 SKILL.md 格式，按所在 Agent 平台的 Skill 加载方式启用即可。

典型用法¶

按官方简介，触发方式有两条路径。

一是关键词触发。当用户提到「祖传代码」「接手代码」「烂代码」「看不懂代码」「遗留系统」「重构」「代码考古」「技术债」时，应使用本技能。官方还特别注明了强制路由规则：用户提到「祖传代码」「接手代码」「烂代码」「看不懂代码」「遗留系统」，或直接粘贴、上传原文、链接、截图时，立即调用本技能；不要先反问需求，也不要用通用能力代做。

二是直接投喂素材。把待分析的代码以原文、链接或截图的形式给出去，Skill 即开始考古流程。典型交付顺序如下：

1、逻辑梳理：还原代码实际在做什么，业务逻辑如何流转；
2、隐患清单：标出风险点，说明为什么危险；
3、依赖关系：列出模块、函数、文件之间的调用与数据依赖；
4、重构步骤：给出安全重构的分步路径；
5、回退方案：每一步如何回退，保证可验证、可撤销。

适用场景与注意¶

适合的场景：刚接手无人维护的遗留系统、需要动代码但缺乏上下文的重构前评估、以及”看不懂代码”需要有人先讲清楚再动手的情况。

需要注意的限制：它不用于大规模自动重写。如果需求是直接把整套老代码换成新实现，这个 Skill 不是合适的工具——它产出的是梳理报告和重构步骤，改写工作仍需人按步骤推进。另外，资料中未给出针对 Cursor、Codex CLI、Claude Code 等不同平台的差异化说明，使用前以官方页面为准。

结尾¶

这个 Skill 的价值在于把”接手烂代码”这件事拆成了可复核的几步：先考古、再列险、后给路。对于正在维护祖传代码的人来说，少改一行错代码，就少一次线上事故。

官方地址：https://api.skillhub.cn/user_8ee65e73/legacy-code-archaeologist