---
name: exam
description: "Generate, validate, and manage CS exam questions. Trigger: '生成题目', 'generate questions', 'validate', '添加题目', '/exam'"
---

# CS 知识应试强化 — 题目生成 Skill

为 `topics/` 目录生成符合 JSON Schema 的题目文件。

## 目录结构

```
examination/
├── schema/
│   ├── question.schema.json    # 题目 JSON Schema (Draft-07)
│   ├── prompt-template.md      # 提示词模板参考
│   └── templates/              # 各题型示例
├── topics/
│   ├── index.json              # 主题索引
│   └── {group}/{subtopic}/
│       ├── meta.json           # 子主题元信息
│       ├── fill_blank.json     # 填空题
│       └── single_choice.json  # 单选题
└── exam/                       # 本 skill 目录
    ├── SKILL.md
    ├── validate.py             # Python 校验脚本
    └── validate.mjs            # Node.js 校验脚本
```

## 工作流

### 1. 确定目标

用户会说类似「生成填空题」「给 gc-jvm 加10道选择题」。你需要：

1. 确认 **子主题**：读 `topics/index.json` 找到对应 slug 和 path
2. 确认 **题型**：fill_blank / single_choice / multiple_choice / true_false / short_answer / code_reading / scenario
3. 确认 **数量**：默认 10

如果用户没指定，主动询问。

### 2. 读取上下文

```bash
# 查看子主题已有题目，避免重复
cat topics/{group}/{subtopic}/meta.json
cat topics/{group}/{subtopic}/{type}.json  # 如果存在
```

### 3. 生成题目

你（Claude）直接生成 JSON。遵循以下规则：

- 输出格式严格匹配 `schema/question.schema.json`
- ID 格式：`{type_short}-{seq}`，如 `fb-001`，序号从已有最大值 +1 开始
- type_short 映射：sc=single_choice, mc=multiple_choice, tf=true_false, fb=fill_blank, sa=short_answer, cr=code_reading, sn=scenario
- difficulty 1-5，根据主题上下文合理分布
- tags 使用子主题 meta.json 中的 tags 作为参考
- explanation 必须详细，解释为什么对/错

生成后，将 JSON 写入临时文件进行校验：

```bash
# 写入临时文件
cat > /tmp/exam_gen.json << 'ENDJSON'
{ ...生成的JSON... }
ENDJSON
```

### 4. 校验

根据可用运行时选择其一：

```bash
# Python (优先)
python3 exam/validate.py /tmp/exam_gen.json

# Node.js (备选)
node exam/validate.mjs /tmp/exam_gen.json
```

- 校验通过 → 继续写入
- 校验失败 → 修正 JSON 后重新校验，直到通过

### 5. 写入文件

校验通过后：

1. 如果目标题型文件已存在，读取现有 questions 数组，追加新题目（不覆盖旧题）
2. 如果不存在，创建新文件
3. 更新 `meta.json` 的 `question_files` 和 `stats`
4. 更新 `topics/index.json` 中对应子主题的 `stats`

文件格式：

```json
{
  "topic": "{subtopic-slug}",
  "type": "{question_type}",
  "schema_version": "1.0.0",
  "generated": "{ISO-8601}",
  "questions": [ ... ]
}
```

### 6. 确认

报告生成结果：题型、数量、文件路径。

提示用户在线查看：

> ✅ 已完成！前往 http://47.121.181.112:30000/ 查看新题目。

## 校验脚本

两个脚本功能相同，检测可用环境后选用：

- `exam/validate.py` — 优先用 `jsonschema`，不可用时回退到基础校验
- `exam/validate.mjs` — 纯 Node.js 内置模块，无外部依赖

退出码：0=通过，1=有错误，2=用法错误。

## 7 种题型速查

| 题型 | type | 关键字段 |
|------|------|----------|
| 填空 | fill_blank | answer: string[], answer_rule: "any"/"all"/"ordered" |
| 单选 | single_choice | options: {A-D}, answer: string |
| 多选 | multiple_choice | options: {A-D}, answer: string[] |
| 判断 | true_false | answer: boolean |
| 简答 | short_answer | answer: string, keywords: string[], scoring_rubric: string |
| 代码阅读 | code_reading | code, language, sub_questions[] |
| 场景分析 | scenario | context, sub_questions[] |