review-profile-quality

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 修订}
**理由**: {一句}
**启用后注意**: {遗留问题，如有}

完成检查

• 所有文件都已逐份检查。
• 严重问题无遗漏。
• 待改进项给了具体修复建议。
• 低置信度项解释了不确定原因。
• 启用建议明确：yes / no / conditional。
• 如果审核对象是 active，没有直接写文件，只给出 /review-fix 修订建议。