前言¶
高考志愿阶段，考生和家长常要在「分数 ↔ 省排名 ↔ 分数段」之间来回换算。一分一段表数据按省份、年份、选科拆分，政策上还有传统文理、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，已核实能力如下。
-
从自然语言抽取查询条件
Agent 按步骤识别：地区（place）、年份（year）、选科（classify）、分数（score）、省排名（rank）。地区支持别称、错别字容错和城市到省份映射；未识别地区时会追问省份。 -
按省份与年份适配选科规则
结合ref/classify.json与文档中的新高考切换表，在传统文理、3+3（综合）、3+1+2（物理/历史）之间做映射与纠错；内蒙古蒙授类单独处理。 -
一分一段数据查询
在确认地区、年份、选科后调用fetch_data.py。支持：
---score：按分数查该分段人数与累计位次（省排名）；
---rank：按位次反查对应分数区间；
- 未带分数或位次时仍可拉取分段表数据，并在对话中引导用户补充分数或排名。 -
输出约束
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 里做高考志愿辅助、一分一段换算的开发者或内容团队；
- 需要把「省 + 年 + 选科 + 分/位次」结构化后再答问题的场景，而非纯开放域闲聊。
限制与注意
- 数据与政策时效：接口数据来自
https://gaokao.search.qq.com/skills_data（脚本内type=score_range）。实际填报仍以各省考试院公布为准；Skill 内「今年」按文档指 2026、「去年」指 2025，跨年后需关注 Skill 是否更新。 - 网络环境：
fetch_data.py需能访问上述域名；离线环境无法查表。 - 选科与年份必须匹配：新高考切换年份表写在
SKILL.md中，年份或选科填错会导致结果与考生实际科类不一致。 - 企业源与统计：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 。
