Skill Forge Quiz - 内容生成

此 Skill 提供为 Skill Forge 系统 生成试卷内容 的工具。它直接写入共享数据库，但不管理运行环境。

核心能力

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

使用说明

1. 导入试卷

从 JSON 文件导入试卷：

# 标准导入
node scripts/import_quiz.js <JSON文件路径>

# 示例
node scripts/import_quiz.js ./quiz_template.json

说明：import_quiz.js 会先检查 skill-forge-base 的 Dashboard 服务是否已启动；若未启动会自动启动（并等待端口就绪），然后再执行导入。

JSON 模板格式

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

{
    "topic": "主题名称",
    "topic_detail": "详细描述（可选）",
    "difficulty": "beginner|intermediate|advanced",
    "questions": [
        {
            "content": "题目内容",
            "type": "choice|essay|code",
            "options": ["选项1", "选项2"],
            "correct_answer": "正确答案",
            "explanation": "解析",
            "knowledge_points": ["知识点1"],
            "score": 10
        }
    ]
}

数学公式（LaTeX 规范）

当题目/解析里包含数学表达式（例如 f(x)=e^{3x}、极限、积分、矩阵等）时，必须使用 LaTeX 语法，并且必须放在可渲染分隔符内（否则页面会按普通文本显示）。

规范（务必遵守）：

数学表达式必须放在 $...$ （行内）或 $$...$$（独立公式）内。
任何形如 \\lim_{...}、e^{...}、x_{...}、\\frac{...}{...} 的表达式，如果不在 $...$ /$$...$$ 内，都会以普通文本显示（无法渲染成数学符号）。
选择题/多选题的 options[] 禁止手写 A./B./C./D. 前缀（页面会自动加字母前缀；手写会导致 A. A. ...）。

正确写法（推荐直接复制）：

行内公式：使用 $...$ ，例如：如果 $f(x)=e^{3x}$，求 $f'(x)$。
独立公式：使用 $$...$$（适合较长推导或多行公式）

常见写法示例：

极限： $\\lim_{x\\to a} f(x) = L$
分数： $\\frac{a}{b}$
下标/上标： $x_{n+1}$ 、 $e^{3x}$

注意事项：

生成 JSON 时，LaTeX 依然是普通字符串；必要时对反斜杠进行转义（例如 \\frac{a}{b}）。
只有被分隔符包裹的 LaTeX 才会被渲染：例如 lim_{x->a} 不会渲染；必须写成 $\\lim_{x\\to a}$ 或 $$\\lim_{x\\to a}$$。
不要输出“看起来像公式的纯文本”，公式部分尽量用 $...$ 包裹。

提交前自检（输出 JSON 前必须逐条检查）：

是否出现了 lim_{ / e^{ / x_{ / \\frac{ 等片段但没有 $...$ 包裹？
options[] 是否有以 A./B./C./D. 开头的项？
是否把公式和普通文字混在一起导致 KaTeX 无法解析（不确定时，把公式部分单独放进 $...$ ）？

交互流程规范

1. 试卷生成流程

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

确保 Dashboard 已运行：
- 通过端口检测确认 skill-forge-base 的 Node 服务已启动（默认 localhost:3457，以 ~/.skill-forge/config.json 为准）。
- 若未启动，则启动 skill-forge-base（推荐直接调用 node scripts/import_quiz.js ...，该脚本会自动完成检查与启动）。
参数确认：主动询问并确认以下 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: 编程题（支持代码高亮）
内容生成：
- Agent 根据确认的参数，使用自身的 LLM 能力生成符合 quiz_template.json 格式的 JSON 数据。
- 注意：在 JSON 的 questions 数组中，应为每个问题设置 source_type（如 ai_generated 或 official_doc）。
写入与导入：
- 将生成的 JSON 保存为临时文件（例如 temp_quiz_<timestamp>.json）。
- 使用 node scripts/import_quiz.js <temp_file> 导入数据库。
- 导入成功后，必须删除临时文件。
反馈：
- 告知用户导入成功。
- 提供 Dashboard 的访问链接（通常是 http://localhost:3457）以便用户开始测验。

2. 试卷导入流程

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

确保 Dashboard 已运行（同上）。
格式验证：检查文件是否符合 quiz_template.json 的结构（必须包含 topic 和 questions 数组）。
执行导入：直接运行 node scripts/import_quiz.js <filepath>。

常用命令

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

依赖

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

skill-forge-quiz