skill-forge-quiz

1. 导入试卷：从 JSON 文件导入试卷。
2. 生成试卷：（规划中）AI 驱动的试卷生成。

1. 导入试卷

从 JSON 文件导入试卷：

```bash

# 标准导入

node scripts/import_quiz.js

# 示例

node scripts/import_quiz.js ./quiz_template.json

```

JSON 模板格式

参考项目中的 quiz_template.json 文件：

```json

{

"topic": "主题名称",

"topic_detail": "详细描述（可选）",

"difficulty": "beginner|intermediate|advanced",

"questions": [

{

"content": "题目内容",

"type": "choice|essay|code",

"options": ["A. 选项1", "B. 选项2"],

"correct_answer": "正确答案",

"explanation": "解析",

"knowledge_points": ["知识点1"],

"score": 10

}

]

}

```

1. 试卷生成流程

当用户请求"生成试卷"或"创建测验"时，Agent 必须遵循以下流程：

1. 参数确认：主动询问并确认以下 4 个关键参数：

* 主题 (Topic): 测验的核心知识点或技术栈（例如：React Hooks, HTTP 协议）。

* 难度 (Difficulty): beginner (初级), intermediate (中级), 或 advanced (高级)。

* 题目数量 (Question Count): 建议 5-20 题。

* 题目来源 (Source): 明确内容的来源:

* 纯 AI 生成: (ai_generated) 完全由模型根据知识库生成。

* 用户提供: (manual) 基于用户提供的文档或文本。

* 网络搜索: Agent 使用 search_web 工具搜索相关资料，可细分为：

官方文档* (official_doc): 技术官网、规范文档。

社区讨论* (community): StackOverflow, GitHub, 技术博客。

面试真题* (interview): LeetCode, 牛客网, 面经网站。

考试题库* (exam): 认证考试、学术试题。

考试题库* (exam): 认证考试、学术试题。

* 注意:

* 生成 JSON 时请将对应的类型填入 source_type 字段。

* 如使用 Brave Search，请务必在两次搜索之间间隔 1秒 以上，以避免 429 Too Many Requests 错误。

* 题型占比 (Distribution): 询问用户希望的题型分布（例如："全是单选" 或 "一半单选，一半代码题"）。支持的题型包括：

* choice: 单项选择题

* multiple_choice: 多项选择题

* essay: 问答/简答题

* code: 编程题（支持代码高亮）

1. 内容生成：

* Agent 根据确认的参数，使用自身的 LLM 能力生成符合 quiz_template.json 格式的 JSON 数据。

* 注意：在 JSON 的 questions 数组中，应为每个问题设置 source_type（如 ai_generated 或 official_doc）。

1. 写入与导入：

* 将生成的 JSON 保存为临时文件（例如 temp_quiz_.json）。

* 使用 node scripts/import_quiz.js 导入数据库。

* 导入成功后，必须删除临时文件。

1. 反馈：

* 告知用户导入成功。

* 提供 Dashboard 的访问链接（通常是 http://localhost:3457）以便用户开始测验。

2. 试卷导入流程

当用户提供现成的 JSON 文件进行导入时：

1. 格式验证：检查文件是否符合 quiz_template.json 的结构（必须包含 topic 和 questions 数组）。
2. 执行导入：直接运行 node scripts/import_quiz.js 。

• 导入试卷: node scripts/import_quiz.js
• 查看帮助: node scripts/import_quiz.js --help

• Node.js: >= 14.0.0
• SQLite3: 数据库访问
• 前置条件: 需要 ~/.skill-forge/skill-forge.db 已由 skill-forge-base 初始化。