skill-forge-quiz

# Skill Forge Quiz - 内容生成

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

## 核心能力

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

## 使用说明

### 1. 导入试卷
从 JSON 文件导入试卷：

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

# 示例
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`: 编程题（支持代码高亮）

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