前言¶

在给 Agent 做教育类功能时，一个常见痛点是：模型本身不内置可检索的题库。你想按知识点组一套五年级小数乘法的题，或者把某套试卷原样拉出来导出 Word，靠模型自己生成既不稳定，也拿不到标准答案和解析。这个 Skill 的作用是把这类需求转成对第三方题库供应商 API 的调用，让 Agent 按固定步骤去取题、搜题、取解析、出卷。

下面介绍它是什么、能做什么、怎么启用，以及使用前需要确认的几件事。

这是什么¶

k12题库api 是一个基于通用 SKILL.md 格式的接口型 Skill，由 SkillHub 社区发布者 user_638f6e0d 维护，坐标 @user_638f6e0d/k12-questions-apihub，版本 1.0.0，分类 education，来源 community。它本身不生产题目，而是把「调用第三方题库供应商接口」封装成一套可重复执行的流程，覆盖小学、初中、高中题库，以及中考、高考真题。

一句话定位：Agent 的取题/组卷执行器，题目数据来自外部题库供应商。

核心功能¶

按 Skill 自身描述，它覆盖以下能力：

1、按知识点取题：给定学科与知识点，返回对应试题。
2、按章节取题：支持语文、英语等按章节拉题。
3、按试卷取题：取出整套试卷的题。
4、试题搜索：按关键词搜一道题（例如「浮力」）。
5、获取答案解析：对已取出的题目取答案与解析。
6、生成 Word 试卷：把取出的题目导出成 Word。

配套入口是两个文件：用 scripts/qb.py 调用接口，用 references/api_docs.md 查完整的端点与字段说明。这两个路径来自 Skill 的描述信息，启用后可在 Skill 目录内找到。

启用与配置¶

Skill 以标准 SKILL.md 目录形式分发，启用方式取决于你用的是哪种 Agent 宿主。目前公开页面只给出坐标与下载地址，没有提供统一的一键安装命令，因此这里不写未经核实的命令，按你所用工具的 Skill 安装流程放入该坐标即可。

需要特别说明的配置项：该 Skill 带 requires_api_key=true 标签，调用前必须先向题库供应商购买 API key，并把它配置到运行环境中。没有 key，取题、搜题、导出都会失败。

Codex CLI、Cursor、Claude Code 三者的 Skill 安装方式若存在差异，应以各自官方文档为准，这里不做未经核实的断言。

典型用法¶

这个 Skill 的调用入口是自然语言触发。下面这些说法会命中它（示例来自 Skill 描述中的 trigger phrases）：

• 按知识点出题：「找五年级数学小数乘法的题」
• 按章节取题：「按章节取题（语文/英语）」
• 取整套试卷：「取出这套试卷的题」
• 搜索单题：「搜一道关于浮力的题」
• 取解析：「获取这道题的答案」
• 导出：「把题目导出成 Word」「组卷」
• 直接调接口：「调题库接口」

落到执行层面，Skill 内部会调用 scripts/qb.py 完成实际的接口请求，字段级细节以 references/api_docs.md 为准。建议先读一遍 api_docs.md，确认端点与返回字段，再决定取题粒度。

适用场景与注意¶

适合：已持有题库供应商 API key、需要在 Agent 工作流里稳定取题或组卷的场景，例如自动出练习、批量组卷、把真题卷转成 Word。

注意几点：
1、数据依赖外部供应商，接口可用性、题目覆盖范围、更新频率都以供应商为准，Skill 只是调用层。
2、需要有效 API key，成本与配额由供应商决定。
3、评分与下载数据以 SkillHub 页面为准（页面显示评分 100000、下载 2275 次、安装 0）；不同抓取时间可能看到不同数值。
4、题目内容的版权与合规责任在供应商与使用方，导出 Word 前自行确认授权范围。

结尾¶

k12题库api 的价值在于把「取题—搜题—解析—组卷」这条链路固定下来，让 Agent 不用临时拼凑，而是按统一接口调用第三方题库。如果你已经有可用的题库 API key，可以从官方地址入手。

官方地址：https://api.skillhub.cn/user_638f6e0d/k12-questions-apihub
SkillHub 页面：https://www.skillhub.cn/skills/user_638f6e0d/k12-questions-apihub