2026-09-02 20:42:54 +08:00
|
|
|
|
---
|
|
|
|
|
|
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 # 单选题
|
2026-09-02 20:49:29 +08:00
|
|
|
|
└── exam/ # 本 skill 目录
|
|
|
|
|
|
├── SKILL.md
|
2026-09-02 20:42:54 +08:00
|
|
|
|
├── 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 (优先)
|
2026-09-02 20:49:29 +08:00
|
|
|
|
python3 exam/validate.py /tmp/exam_gen.json
|
2026-09-02 20:42:54 +08:00
|
|
|
|
|
|
|
|
|
|
# Node.js (备选)
|
2026-09-02 20:49:29 +08:00
|
|
|
|
node exam/validate.mjs /tmp/exam_gen.json
|
2026-09-02 20:42:54 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- 校验通过 → 继续写入
|
|
|
|
|
|
- 校验失败 → 修正 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/ 查看新题目。
|
|
|
|
|
|
|
|
|
|
|
|
## 校验脚本
|
|
|
|
|
|
|
|
|
|
|
|
两个脚本功能相同，检测可用环境后选用：
|
|
|
|
|
|
|
2026-09-02 20:49:29 +08:00
|
|
|
|
- `exam/validate.py` — 优先用 `jsonschema`，不可用时回退到基础校验
|
|
|
|
|
|
- `exam/validate.mjs` — 纯 Node.js 内置模块，无外部依赖
|
2026-09-02 20:42:54 +08:00
|
|
|
|
|
|
|
|
|
|
退出码：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[] |
|
