前言¶

高考志愿阶段，考生和家长常要在「分数 ↔ 省排名 ↔ 分数段」之间来回换算。一分一段表数据按省份、年份、选科拆分，政策上还有传统文理、3+3、3+1+2 等差异，单靠记忆或手工查表很容易漏参数。若在 Cursor、Claude Code 等 Agent 里用自然语言问「某省某分大概排多少名」，模型若没有结构化数据源，往往只能泛泛而谈。

下面介绍 SkillHub 上的企业源 Skill Tencent Yuanbao Gaokao - Score-to-Rank Lookup（坐标 @tencent-adm/score-range）。它把地区、年份、选科等槽位抽取、新高考选科纠错，以及一分一段表查询串成固定流程，并通过本地脚本拉取腾讯高考检索侧数据，适合在 Agent 对话里做可核对的一分一段查询。

这是什么¶

Tencent Yuanbao Gaokao - Score-to-Rank Lookup 是面向高考「一分一段表」的信息检索 Skill：根据分数查省排名（累计位次）、根据位次反推分数区间，或在给定条件下展示分段表。SkillHub 分类为 knowledge-management，来源为 enterprise，发布者为 元宝高考通，当前版本 0.1.3。页面标注 requires_api_key=false，安装 Skill 本身不需要额外 API Key；查询数据由 Skill 包内的 fetch_data.py 访问 gaokao.search.qq.com 接口完成。

官方入口：

• API / 资源页：https://api.skillhub.cn/tencent-adm/score-range
• SkillHub 详情：https://www.skillhub.cn/skills/tencent-adm/score-range

核心功能¶

依据 Skill 包内 SKILL.md 与 fetch_data.py，已核实能力如下。

1. 从自然语言抽取查询条件
   Agent 按步骤识别：地区（place）、年份（year）、选科（classify）、分数（score）、省排名（rank）。地区支持别称、错别字容错和城市到省份映射；未识别地区时会追问省份。

2. 按省份与年份适配选科规则
   结合 ref/classify.json 与文档中的新高考切换表，在传统文理、3+3（综合）、3+1+2（物理/历史）之间做映射与纠错；内蒙古蒙授类单独处理。

3. 一分一段数据查询
   在确认地区、年份、选科后调用 fetch_data.py。支持：
   - --score：按分数查该分段人数与累计位次（省排名）；
   - --rank：按位次反查对应分数区间；
   - 未带分数或位次时仍可拉取分段表数据，并在对话中引导用户补充分数或排名。

4. 输出约束
   Skill 要求必须通过 ./fetch_data.py 取数，禁止 Agent 绕过脚本直接拼完整 API 请求；脚本 stdout 为 JSON，便于模型解析。

安装与启用¶

安装方式以 SkillHub 官方说明为准：https://skillhub.cn/install/skillhub.md

先确认本机是否已有 skillhub CLI：

command -v skillhub && skillhub --version

若未安装，可使用官方一键脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 @tencent-adm/score-range 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 页面给出的包名为 @tencent-adm/score-range，对应 CLI 安装示例：

skillhub install score-range --namespace tencent-adm --dir <你的 Agent skills 目录>

常见客户端 skills 路径（来自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按你所用客户端的要求重启或刷新 Agent，使 SKILL.md 被加载。Skill 包内自带 ref/place.json、ref/classify.json 等参考数据及 fetch_data.py，运行查询需本机可用的 python3。

典型用法¶

在 Agent 对话中（推荐）
启用 Skill 后，用口语描述省份、年份、选科和分数或位次即可，Agent 会按 SKILL.md 的 Step 1～9 执行。例如（意图示例，非保证固定话术）：

• 「福建 2024 年历史类 600 分大概省排多少？」
• 「北京去年综合 650 分对应位次？」
• 「广东物理类，位次 5000 大概在什么分数段？」

若用户只给了省份和选科、未给分数或排名，Skill 会按流程反问分数或省排名后再查。

直接调用脚本（调试或核对）
在 Skill 目录下，与 fetch_data.py 注释一致的调用方式：

python3 ./fetch_data.py --place 福建 --year 2024 --classify 历史 --score 600

按位次查询时增加 --rank，例如：

python3 ./fetch_data.py --place 福建 --year 2024 --classify 历史 --rank 1000

多省份、多年份、多选科时，参数值之间以空格分隔（与 SKILL.md 中 place/year/classify 的约定一致）。返回 JSON 中，score 为分数或分数段，num 为该分人数，total_num 为累计人数（位次）。

适用场景与注意¶

适合谁

• 在 Agent 里做高考志愿辅助、一分一段换算的开发者或内容团队；
• 需要把「省 + 年 + 选科 + 分/位次」结构化后再答问题的场景，而非纯开放域闲聊。

限制与注意

1. 数据与政策时效：接口数据来自 https://gaokao.search.qq.com/skills_data（脚本内 type=score_range）。实际填报仍以各省考试院公布为准；Skill 内「今年」按文档指 2026、「去年」指 2025，跨年后需关注 Skill 是否更新。
2. 网络环境：fetch_data.py 需能访问上述域名；离线环境无法查表。
3. 选科与年份必须匹配：新高考切换年份表写在 SKILL.md 中，年份或选科填错会导致结果与考生实际科类不一致。
4. 企业源与统计：SkillHub 页面显示下载约 707 次、安装 1 次（统计随平台更新变化），与第三方转载的下载数可能不一致，以 SkillHub 为准。

结尾¶

Tencent Yuanbao Gaokao - Score-to-Rank Lookup 把一分一段查询拆成可执行的槽位抽取 + 脚本取数流程，并覆盖新老高考选科差异，适合挂在支持 Skill 的 Agent 上做省排名与分数段互查。安装与路径配置见 https://skillhub.cn/install/skillhub.md ，Skill 详情见 https://www.skillhub.cn/skills/tencent-adm/score-range ，资源坐标 https://api.skillhub.cn/tencent-adm/score-range 。