作者加入新团队后，立即面临过时的 API 文档问题，被迫手动在代码库中 grep 路由。这场耗时四小时的经历凸显了开发环境中普遍存在的文档缺失或不准确问题。为解决这一问题，作者开发了"API Archaeologist"，这是一个专为 Claude Code/Codex CLI 设计的技能，旨在直接从源代码逆向工程 API 层。该工具可自动发现各类 API 元素，包括内部端点（REST、GraphQL、gRPC、WebSockets）、外部集成、认证流程以及潜在的安全漏洞（如未认证路由）。API Archaeologist 生成两项关键输出：API_DISCOVERY.md（包含 Mermaid 图表的综合目录）和 openapi-draft.yaml（初步 OpenAPI 规范）。与依赖现有注解或规范的工具体不同，API Archaeologist 分析实际源代码，因此特别适用于遗留系统、初创企业或快速迭代的项目。该技能通过读取 SKILL.md 文件运行，该文件指导 Claude Code 追踪路由定义、处理器、中间件和数据库调用，映射认证机制并识别外部 API 调用。安装过程包括为技能创建目录，并下载适用于 Claude Code 或 Codex CLI 的 SKILL.md 文件。用户随后进入其后端仓库，执行简单命令即可生成报告。作者强调，核心洞察在于代码库中已嵌入大量有价值信息，只需提取并建立关联。尽管 OpenAPI 输出为草案且动态路由可能带来挑战，但该工具旨在简化 API 文档工作。未来计划包括前端 API 消费者映射、Postman 集合导出以及 CI/CD 集成。API Archaeologist 为那些受困于过时或缺失 API 文档的团队提供了解决方案，通过直接解读代码实现这一目标。