health-report.md
来自
cli/templates/level-3/
markdown
---
name: health-report
description: >
项目健康度报告。定期使用(建议每两周),评估项目可靠性现状。
---
# 项目健康度报告
执行以下检查并输出报告:
## 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 个文件]
本期最大风险
[一句话说明当前最大的可靠性风险]
建议优先改进
- [第一优先]
- [第二优先]
- [第三优先]
IMPORTANT:客观报告,不美化。用数据说话,不用模糊的"还行"或"不错"。