| name | review-profile-quality |
| description | 资料包质量审核。对 draft 或 active 资料包进行质量审计、生成 quality_report.md 或审核建议。当 /review-init 完成生成、/review-fix 完成修订、或用户要求审核资料包时加载。 |
Profile Quality
你在 /review-init 的步骤 8、/review-fix 修订后，或用户要求审核资料包时被加载。任务：全面审计资料包。
- 如果目标是
draft：可以通过 review_profile_write 写入或重写 quality_report.md。
- 如果目标是
active：只输出审核意见和修订建议，不直接写 active。需要修改时，引导用户使用 /review-fix 创建 revision draft。
审计方法
逐文件检查，不是抽查。发现一个问题记一个问题，宁可多记不少记。
必查兼容项
knowledge_index.json 必须包含 chapters object，且每个章节都必须有 knowledge_points 数组。只有顶层 knowledge_points 或只有 chapters.*.sections 的资料包不能通过审核。
审计维度
完整性
subject.md、knowledge_index.json、source_map.json 是否存在。cards/ 是否覆盖了核心知识点；非核心知识点缺卡是否已在报告中说明。exam_points/ 是否覆盖了主要章节；缺失章节是否影响模式 2。chapters/ 和 knowledge_index.json 的章节数是否一致。source_map.json 中是否有源文件未被映射。
一致性
- 章节编号：index ↔ chapters/ 目录名 ↔ exam_points/ 文件名，三者一致。
- ID 引用：卡片和考点总结中引用的知识点 ID 在 index 中都存在。
- 难度标注：同一知识点在 index、卡片、考点总结中的难度一致。
- 文件链接：卡片中的关联链接指向真实文件。
内容质量（抽检 30% 卡片、50% 考点总结）
- 定义是否准确（对照 chapters/ 源内容验证）。
- 代码是否能运行（编程类）；推导是否逻辑正确（数学类）。
- 误区是否具体、是否真实常见。
- 出题提示是否给出了具体方向——不只是"考这个知识点"。
结构质量
- 每章 2-8 个小节。
- 小节文件 30-300 行。
- 卡片 300-1500 字（完整版）。
- 每小节 1-5 个知识点。
安全
- 非 legacy-bridge 资料包路径不含
..。
profile.json 状态与审核场景一致：init/fix 启用前应为 draft；普通只读审核可为 active。source_map.json 中的源文件路径不越界（仅 legacy-bridge 允许外部引用）。
分级
| 级别 | 标准 | 是否阻塞启用 |
|---|
| 严重 | 必选文件缺失、知识点覆盖率 < 80%、章节完全缺失、定义有事实性错误、编程类代码无法运行、路径含 ..、> 20% 源文件无法映射 | ✅ 阻塞 |
| 待改进 | 核心卡片缺失、考点总结缺失、误区虚泛、出题提示不具体、章节粒度偏粗/细、文件大小超标 | ❌ 不阻塞 |
| 低置信度 | AI 不确定的切分、模糊的章节归属、可能有多种解读的定义 | ❌ 不阻塞 |
报告格式
# 资料包质量报告
**科目**: {名称} | **Subject ID**: {id} | **审核时间**: {ISO 8601} | **状态**: {draft/active}
## 整体评估
{诚实评价。不要模板套话。}
**质量评级**: {优秀 / 良好 / 待改进 / 需重新生成}
## 基础数据
| 指标 | 数值 | 状态 |
|------|------|------|
| 源文件 | {N} | — |
| 成功映射 | {N1}/{N} | ✅/⚠️ |
| 章节 | {K} | — |
| 小节 | {S} | ✅/⚠️ |
| 知识点 | {M} | — |
| 卡片 | {C}/{M} | ✅/⚠️ |
| 考点总结 | {E}/{K} | ✅/⚠️ |
## 严重问题
{逐个：编号 + 类型 + 位置 + 描述 + 影响 + 修复建议}
{没有就写"✅ 未发现严重问题"}
## 待改进项
| # | 类型 | 位置 | 描述 | 严重度 | 建议 |
|---|------|------|------|--------|------|
## 低置信度项
| # | 位置 | 内容 | 不确定原因 |
|---|------|------|-----------|
## 无法处理的源文件
| 文件 | 原因 | 影响 | 建议 |
|------|------|------|------|
## 完整清单
- [x] subject.md
- [x] knowledge_index.json
- [ ] cards/ — 完整 {C1} / 简化 {C2} / 缺失 {C3}
- [x] chapters/ — {K} 章 {S} 小节
- [x] exam_points/ — {E}/{K} 份
- [x] source_map.json
- [x] 路径安全检查
- [x] 状态检查（{draft/active}）
## 修订记录
| 版本 | 时间 | 来源 | 变更 |
|------|------|------|------|
| v1 | {时间} | /review-init | 初始生成 |
## 启用建议
**建议**: {可以启用 / 修复严重问题后启用 / 补充资料后重新生成 / active 需创建 revision draft 修订}
**理由**: {一句}
**启用后注意**: {遗留问题，如有}
完成检查
