Skip to content

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 个文件]

本期最大风险

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

建议优先改进

  1. [第一优先]
  2. [第二优先]
  3. [第三优先]

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

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