前言¶
填志愿前，考生和家长常要对照「一分一段表」：同一分数对应多少人在你前面、某个位次大概落在什么分数段。数据多在各省考试院或第三方页面里，年份、科类、批次字段不统一，自己整理再喂给大模型，既慢也容易漏条件。
若在 Cursor、Claude Code 等支持 Skills 的客户端里装一个专门处理一分一段检索的 Skill，可以把「查位次、反推分数、要整张表」收敛成对话里的结构化请求，由 Skill 按约定流程调用背后能力。下面介绍 SkillHub 上的 元宝高考通-一分一段查询（坐标 @tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup）是什么、能做什么，以及如何安装与使用。
这是什么¶
元宝高考通-一分一段查询 是面向高考志愿填报场景的一分一段信息检索助手，采用通用 SKILL.md 格式发布在 SkillHub，当前版本 v1.0.2，分类为 education，来源标注为 enterprise，发布者为 元宝高考通。页面标签为 requires_api_key=false，表示按 SkillHub 说明无需单独配置 API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup
- API 文档地址：https://api.skillhub.cn/tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup
它要解决的核心问题：在对话中根据 分数 查 全省排名位次，或根据 位次 估算 对应分数区间，或直接提供 一分一段表 查询能力，减少手工找表、对表的时间。
核心功能¶
以下能力均来自 SkillHub 简介与页面说明，未在资料中出现的细节不作延伸。
- 分数 → 位次：按考生分数查询其在对应省份、考试语境下的排名位次（一分一段语义下的「同分人数 / 累计位次」类信息，由 Skill 内流程组织查询）。
- 位次 → 分数区间：根据目标位次，估算可能对应的分数区间，便于从「想冲的位次」反推大概要多少分。
- 一分一段表：在需要整张表或分段数据时，由助手按 Skill 约定提供一分一段表相关检索结果。
SkillHub 侧统计（以页面抓取为准）：评分 100000，下载 2472 次（安装计数在抓取时为 0，以 SkillHub 实时展示为准）。
安装与启用¶
安装分两种方式：把提示词发给当前 Agent，或在本机用 SkillHub CLI 装到对应客户端的 skills 目录。无论哪种，装好后需让 Agent 能加载该目录下的 Skill（部分客户端需重启或刷新技能列表）。
方式一：提示词安装（官方页面推荐）¶
将下面意图发给支持 Skills 的 AI，让其按 SkillHub 安装文档操作：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup`。
Agent 会按文档检查 skillhub CLI、选择正确的 --dir 等步骤。
方式二：SkillHub CLI¶
先确认是否已安装 CLI（摘自 SkillHub 安装文档）：
command -v skillhub && skillhub --version
未安装时可执行完整安装（需网络权限）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端识别。常用路径示例（同样来自安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形如：
skillhub install @tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup --dir ~/.cursor/skills/
将 --dir 换成你实际使用的客户端路径即可。Codex 若使用项目级 .agents/skills/，把目录改为对应项目路径。
资料中未单独列出 Cursor / Codex / Claude Code 的安装差异，差异主要体现在 skills 目录路径 与客户端是否已启用 Skills 功能，安装包坐标与版本一致。
典型用法¶
官方简介未给出固定 HTTP 示例或脚本入口，典型用法是在已启用该 Skill 的对话里，用自然语言说明 省份、年份、科类/选科、分数或位次 等条件，由 Agent 按 SKILL.md 流程调用一分一段检索能力。下列表述方式与简介中的三类能力对应，便于复现意图（具体返回字段以 Skill 运行时为准）：
-
按分数查位次
「请用一分一段数据查：某省、某年高考，物理类（或历史类/综合，按你所在省份表述），总分 620 分对应的全省位次大概是多少？」 -
按位次估分数
「某省某年某科类，位次大约在 5000 名，对应分数大概在什么区间？」 -
要一分一段表
「提供某省某年某科类的一分一段表（或某分数段附近的分段数据）。」
经过上面的步骤，你无需在对话外先下载 Excel 再粘贴；Skill 负责把「查表」类任务收敛到统一流程。若某年某省数据尚未收录，应以助手返回的说明为准，不宜自行假定一定有结果。
适用场景与注意¶
适合谁
- 正在做志愿方案、需要频繁换算「分数 ↔ 位次」的考生与家长，希望在 IDE 或 AI 客户端里和代码、笔记同一环境完成查询。
- 写高考相关工具、答疑 Bot 的开发者，希望在 Agent 侧挂一个 education 类、无需 API Key 的一分一段 Skill 作为能力模块。
限制与注意
- 一分一段数据依赖发布方维护的省份、年份、科类覆盖；对话里务必写清边界条件，避免跨省、跨年混用。
requires_api_key=false仅表示 SkillHub 标注无需额外 Key；实际数据时效与口径仍以 元宝高考通 _skill 内说明及返回结果为准。- 志愿填报涉及政策与个体差异，Skill 输出宜作参考，不能替代省考试院官方发布与招生章程。
- 安装后若客户端未识别 Skill，优先检查
--dir是否指向正确目录，并参考 SkillHub 安装文档中关于重启的说明。
结尾¶
元宝高考通-一分一段查询 把「按分查位次、按位次估分、查一分一段表」三类常见需求封装成 SkillHub 上的标准 Skill，坐标 @tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup，当前 v1.0.2，无需 API Key 即可按文档安装。需要查看简介、版本与安装提示时，可打开 SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencent-yuanbao-gaokao-score-to-rank-lookup 。
