check.md

来自 cli/templates/level-3/

---
name: check
description: >
  项目合规体检。随时可用，检查代码和配置是否符合体系规范。
  脚本 check 的智能补充层，处理需要理解代码语义的检查项。
---

# 项目合规体检

先运行脚本的基础检查（如果可用）：
`./scripts/ai-dev.sh check 2>/dev/null || true`

然后执行以下 AI 深度检查：

## 1. CLAUDE.md 健康度
- "架构" 章节是否与实际目录结构一致
- "命令" 章节是否与 package.json scripts 一致
- "常见陷阱" 中是否有过时条目
- 指令条数接近 150 条时给出警告

## 2. 代码规范深度检查
- 抽查 5 个最近修改的 .ts/.tsx 文件：类型完整性、zod 校验、AppError 使用、裸 throw
- 检查 services/ 函数是否有返回类型注解

## 3. 依赖合规
- 对比 package.json 与 docs/approved-deps.md，列出未在白名单中的依赖

## 4. 测试覆盖评估
- 对比 src/ 模块与测试文件，标出完全没有测试的核心模块（services/, app/api/）

## 输出格式

体检报告

合规项

• [列出通过的检查]

需要关注

• [列出警告项，附具体位置和建议]

必须修复

• [列出违规项，附修复建议]

建议

• [可选的改进建议]

IMPORTANT：客观报告，不要美化。没有问题就说没有问题，有问题就直说。