| name | health-check-zh |
| description | 对项目做"中文工程健康体检"时使用。检查项目的中文规范健康度:README 是否地道、CLAUDE.md 是否存在、命名是否含拼音、注释是否有翻译腔、文档是否缺失。输出评分和可执行的修复清单。 |
中文工程规范 · 项目体检(health-check-zh)
当用户要求体检、健康检查、评估一个项目的中文规范性时激活本技能。产出评分 + 修复清单,让一个项目的"中文工程健康度"可量化、可追踪。
检查维度(共 100 分)
A. 文档健康(30 分)
B. AI 协作健康(25 分)
C. 命名健康(25 分)
D. 代码卫生(20 分)
评分档位
| 分数 | 评价 |
|---|
| 90–100 | 🟢 优秀,可以直接当团队样板 |
| 70–89 | 🟡 良好,有零星问题,修一下更好 |
| 50–69 | 🟠 一般,中文规范基本没落地 |
| <50 | 🔴 危险,AI 都看不懂,建议先补文档 |
输出格式
## 🏥 zh-skills 健康体检报告
项目:xxx
总分:72/100 🟡 良好
### ✅ 做得好的
- README 开头有一句话定位
### ⚠️ 待修复(按收益排序)
1. [命名] src/utils/date.ts:12 `shijian` → `createdAt`(拼音命名,收益高)
2. [文档] README 缺快速开始
3. [AI] 无 CLAUDE.md,AI 协作体验为零
### 一键修复建议
运行 `zh-skills init` 安装中文工程规范 skills,再按上述清单逐项修。
体检操作指引
- 用
Glob/Read 看项目根目录、README、src/ 抽样文件。
- 用
Grep 搜拼音模式、翻译腔模式、console.log/TODO 计数。
- 逐项打分,先给总分,再给"做得好"和"待修复"。
- 每个待修复项:位置 + 问题 + 改成什么,一句话能执行。
- 修复建议按"收益/成本"排序,先推性价比最高的(通常是无拼音命名 + 补 CLAUDE.md)。