review-profile-cards

name	review-profile-cards
description	概念卡片生成。按优先级为知识点生成复习卡片（模式 1 使用）。当 /review-init 或 /review-fix 需要生成 cards/ 时加载。

Profile Cards

你在 /review-init 的步骤 5 或 /review-fix 的资料增强阶段被加载。任务：按优先级为 knowledge_index.json 中的知识点生成可被代码匹配的卡片。

不要把“每个知识点必须一张完整卡片”当成硬性要求。卡片质量优先于数量；缺口必须写入 quality_report.md。

生成顺序

分批生成，每 10 张汇报一次进度：

1. 第一批：所有重要性高的知识点 — 完整版。
2. 第二批：所有重要性中的知识点 — 完整版。
3. 第三批：重要性低的 — 可简化或暂缓。

知识点 > 60 时，第三批可以只写定义和误区，或暂不生成。质量报告中标注“完整卡/简化卡/缺失卡”的数量。

卡片格式

推荐路径：cards/{id}.md。

如果使用中文简称作为文件名，frontmatter 必须包含 id 和 aliases，保证 review_card 能按 id/name/alias 匹配。

---
id: {id}
name: {知识点名称}
aliases: [{别名1}, {别名2}]
difficulty: {baseline}
tags: [{tag1}, {tag2}]
chapter: "{章节号}"
source: chapters/{章节号}.{小节号}-{小节名}.md
status: active
---

# {知识点名称}

> **ID**: {id} | **难度**: {baseline} | **标签**: {tag1}、{tag2}

## 定义
{1-3 句准确定义。读完就知道这个知识点是什么。}

## 关键要点
1. **{标题}**：{3-5 句。为什么重要、什么场景用、和其他概念的关系。}
2. **{标题}**：{同上}
3. **{标题}**：{同上}

## 代码示例 / 推导 / 分析模板
```{语言}
{10-25 行，展示核心用法或易错场景。必须可运行。关键行有注释。}
```
{非编程科目换成公式推导、证明路线、案例分析、论文阅读框架等适合的形式。不要为了满足“代码示例”硬造代码。}

## 常见误区
| # | ❌ 误区 | ✅ 正确理解 |
|---|---------|------------|
| 1 | {学生真的会有的错误认知} | {为什么错 + 正确理解} |
| 2 | {同上} | {同上} |

## 关联
- {关联知识点}：{一句话关联说明}
- {没有就写"暂无紧密关联"}

## 出题提示
{具体的考察方向和陷阱设置。不是"考这个知识点"，是"考 X 的触发时机，把 Y 的选项混进去当干扰项"。}

---
*来源：[{章节} > {小节}](chapters/{章节号}.{小节号}-{小节名}.md)*

质量标准

定义：

• ✅ "拷贝构造函数的第一个参数是对同类类型的引用（通常 const T&），在创建新对象时以已有对象初始化。"
• ❌ "拷贝构造函数用于拷贝对象。" — 太模糊。

要点：3-5 个，按重要性递减排列。每个有独立小标题。

示例：按科目选择代码、公式、证明、案例或论点分析。编程类代码必须能跑；非编程科目不要硬写代码。

误区：每条写学生真的会有的想法，不是废话。"不理解拷贝构造"不是误区，"混淆了拷贝构造触发时机和赋值触发时机"才是。

关联：有实质交叉或递进关系。没有就写"暂无"，不要硬凑。

出题提示：至少一个具体命题角度。

兼容要求

• 新卡片必须包含 frontmatter，至少有 id、name、difficulty、tags、chapter、source、status。
• status 默认写 active。如果知识点不再使用，不要删除卡片，改为 status: removed。
• 出题提示 是 agent 使用区，代码展示卡片时默认不展示给学习者。
• 如果某个知识点暂不生成卡片，在 quality_report.md 中列入“卡片缺口”，并说明是否影响模式 1。