repo-health-audit

扫描 TODO 债务、超大文件、硬编码密钥、调试残留、测试占比，输出可排期的整改清单。

触发条件（frontmatter.description）

扫描代码仓库的健康状况（TODO 债务、超大文件、未使用依赖、敏感信息、测试覆盖缺口），输出可执行的整改清单。当用户问"这个项目健康吗""有没有技术债""上线前检查什么"时使用。

目录结构

repo-health-audit/
├── SKILL.md
└── scripts/audit.sh

安装方式

Claude Code把技能目录复制到以下位置，重启会话后自动可用~/.claude/skills/<技能名>/项目级可放 <项目>/.claude/skills/
Claude.ai / Desktop下载 .zip 后在设置 → Capabilities → Skills 上传需要开启 Skills 功能
Hermes Agent放到技能目录，Hermes 启动时自动加载~/.hermes/skills/<技能名>/
其它 Agent任何支持 SKILL.md 约定（YAML frontmatter + 步骤 + 脚本）的框架都可直接使用本质是一个带说明文档的脚本目录

下载的 zip 解压后是 repo-health-audit/ 目录，直接整个放进去即可，不用改文件名。

技能包内容

---
name: repo-health-audit
description: 扫描代码仓库的健康状况（TODO 债务、超大文件、未使用依赖、敏感信息、测试覆盖缺口），输出可执行的整改清单。当用户问"这个项目健康吗""有没有技术债""上线前检查什么"时使用。
---

# 仓库健康检查

## 什么时候用

- 接手一个陌生仓库，想快速摸清风险
- 上线前做一次体检
- 定期（每季度）排查技术债

**不要用**：需要构建/运行才能验证的问题（性能、并发正确性）。

## 步骤

1. 跑 `scripts/audit.sh <repo-path>` 采集客观数据
2. 按五类打分：债务、体积、依赖、安全、测试
3. 每类给出「最该改的 3 件」
4. 按「修复成本 / 风险」排序，给整改顺序

## 输出格式

```
## 体检结论
（一句话：健康 / 有隐患 / 高风险）+ 主要扣分项

## 五类问题
| 类别 | 现状 | 风险 |

## 优先整改（按 ROI 排序）
1. ...（预计成本 / 影响面）
```

## 验证

- 每条问题都要有文件路径或数字支撑，不能是「可能有风险」
- 整改建议要可执行（能写成 issue 标题）

## 陷阱

- 只列问题不给优先级 = 没用
- 把风格问题当技术债（优先噪声）
- 忽略「依赖安全」，这是最容易出事的

SKILL.md 说明（Agent 读到后照此执行）

# 仓库健康检查

## 什么时候用

- 接手一个陌生仓库，想快速摸清风险
- 上线前做一次体检
- 定期（每季度）排查技术债

**不要用**：需要构建/运行才能验证的问题（性能、并发正确性）。

## 步骤

1. 跑 `scripts/audit.sh <repo-path>` 采集客观数据
2. 按五类打分：债务、体积、依赖、安全、测试
3. 每类给出「最该改的 3 件」
4. 按「修复成本 / 风险」排序，给整改顺序

## 输出格式

```
## 体检结论
（一句话：健康 / 有隐患 / 高风险）+ 主要扣分项

## 五类问题
| 类别 | 现状 | 风险 |

## 优先整改（按 ROI 排序）
1. ...（预计成本 / 影响面）
```

## 验证

- 每条问题都要有文件路径或数字支撑，不能是「可能有风险」
- 整改建议要可执行（能写成 issue 标题）

## 陷阱

- 只列问题不给优先级 = 没用
- 把风格问题当技术债（优先噪声）
- 忽略「依赖安全」，这是最容易出事的

目录结构

安装方式

技能包内容

SKILL.md 说明（Agent 读到后照此执行）

同类技能