| name | codebase-inventory-audit |
| description | 代码库清单审计：自动盘点项目代码结构，识别孤儿代码、重复逻辑、文档缺口和技术债务。当用户说'代码库审计'、'项目盘点'、'代码清理'、'技术债务'、'孤儿代码'、'重复代码'、'代码结构分析'、'项目健康度'时触发。核心特点：结构可视化、健康度评分、债务量化、清理优先级。 |
来源: Anthropic Skills Issue #147
发布时间: 2026-05
理念: "不了解自己代码库的人，就像在黑暗中装修房子。"
🗂️ Codebase Inventory Audit — 代码库清单审计
自动盘点代码库，识别技术债务和优化机会。
🎯 核心能力
| 能力 | 说明 |
|---|
| 结构可视化 | 生成模块依赖图、调用关系图 |
| 孤儿代码识别 | 找出无引用的函数、类、文件 |
| 重复逻辑检测 | 识别代码重复、相似函数 |
| 文档缺口扫描 | 找出缺少注释/文档的公共 API |
| 技术债务量化 | 给代码库健康度打分 |
| 依赖分析 | 第三方库使用情况、过时依赖 |
📊 审计维度
1. 代码结构健康度
项目: my-project
├── 模块数量: 23
├── 文件数量: 487
├── 代码行数: 42,380
├── 平均文件行数: 87
├── 最大文件: src/services/legacy/monolith.ts (2,340 行) ⚠️
└── 循环依赖: 3 处 ❌
2. 孤儿代码扫描
| 类型 | 数量 | 示例 |
|---|
| 未引用函数 | 12 | utils/legacyHelper.ts:calculateOldTax |
| 未使用类 | 3 | models/DeprecatedUser.ts |
| 死代码文件 | 5 | hooks/useOldApi.ts |
| 未使用导出 | 18 | constants/oldConfig.ts |
3. 重复代码检测
| 相似度 | 位置 A | 位置 B | 建议 |
|---|
| 85% | auth/login.ts:45-67 | auth/register.ts:32-54 | 提取公共函数 |
| 72% | orders/validate.ts | payments/validate.ts | 创建共享校验器 |
4. 文档缺口
| 文件 | 公共 API | 有文档 | 缺口 |
|---|
api/user.ts | 8 | 3 | 5 |
services/order.ts | 12 | 2 | 10 |
utils/date.ts | 6 | 6 | 0 ✅ |
📈 健康度评分
代码库健康度: 72/100
✅ 结构规范 18/20
⚠️ 代码质量 14/20 （重复代码 15 处）
⚠️ 文档完整 12/20 （38% 公共 API 无文档）
⚠️ 技术债务 13/20 （3 个循环依赖，5 个死文件）
✅ 依赖管理 15/20
🚀 使用方式
方式一：全量审计
对当前项目执行代码库审计
方式二：定向扫描
扫描 src/services 目录的孤儿代码
方式三：债务清理计划
根据审计结果生成技术债务清理计划
按 ROI 排序
🔗 与其他 Skill 的关系
| codebase-inventory-audit | security-audit | systematic-debugging |
|---|
| 侧重 | 代码结构健康 | 安全漏洞 | Bug 排查 |
| 最佳组合 | inventory-audit 发现结构问题 → security-audit 检查漏洞 → hermes-experience 沉淀重构经验 | | |
"定期审计代码库，就像定期体检——早发现，早治疗。"
