Skip to content

/health-report

项目健康度报告。定期使用(建议每两周),评估项目可靠性现状。

项目健康度报告

执行以下检查并输出报告:

1. 测试覆盖评估

  • 列出 services/ 下每个文件是否有对应测试
  • 列出 app/api/ 下每个 Route 是否有对应测试
  • 标注完全没有测试的模块

2. 类型安全评估

  • 运行 npx tsc --noEmit 2>&1 | head -50
  • 搜索代码中的 any 类型使用
  • 搜索 @ts-ignore@ts-expect-error

3. 模块耦合评估

  • 检查是否有组件直接 import prisma
  • 检查是否有跨 Service 的直接调用
  • 检查调用方向是否符合 CLAUDE.md 中定义的架构

4. 风险区域识别

  • 最近 30 次提交中修改最频繁的文件(变更热点 = 风险热点) git log --oneline -30 --name-only | sort | uniq -c | sort -rn | head -10
  • 超过 300 行的文件
  • 有 TODO/FIXME/HACK 的文件

输出格式

## 健康度报告 [日期]

### 得分
- 测试覆盖: [X/Y] 个核心模块有测试
- 类型安全: [数量] 处 any / ts-ignore
- 架构合规: [是否有违反模块边界的情况]
- 变更热点: [最危险的 3 个文件]

### 本期最大风险
[一句话说明当前最大的可靠性风险]

### 建议优先改进
1. [第一优先]
2. [第二优先]
3. [第三优先]

IMPORTANT:客观报告,不美化。用数据说话,不用模糊的"还行"或"不错"。

面向个人开发者的 AI 辅助编程工程化方案