前言¶
填志愿或做升学咨询时,各省录取分数线、批次划分和位次往往分散在不同页面,还要对照当地选科政策(文理分科、3+3、3+1+2)才能问对问题。若把 Agent 当成对话入口,仅靠模型记忆容易年份、批次对不上号。下面介绍 SkillHub 上的企业技能「元宝高考通-地区分数线查询」:由元宝高考通发布,把自然语言问题转成结构化查询,再通过脚本拉取官方数据源中的地区分数线。
这是什么¶
「元宝高考通-地区分数线查询」是面向高考场景的信息检索 Skill,坐标为 @tencent-adm/tencent-yuanbao-gaokao-regional-passing-scores,当前版本 1.0.4,分类为 education,来源标记为 enterprise。SkillHub 页面标注 requires_api_key=false,安装后无需单独配置 API Key。
一句话定位:帮助考生与辅导场景查询各地区高考录取分数线、录取批次及对应排名;实现上依赖 Skill 包内的 ref/ 词典做地区、选科、批次归一化,并由 fetch_data.py 请求腾讯高考检索接口返回结果。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 fetch_data.py 的说明,Agent 按步骤执行即可。
- 地区(place)识别:读取
ref/place.json,支持简称、别称、城市到省份映射;多地区时按地区拆分查询;「各省」「各地区」可映射为「全省」。 - 年份(year)识别:支持明确四位年份;「今年」按文档指 2026,「去年」指 2025;未提及年份则不传 year 字段。
- 选科(student)识别:结合地区与年份判断传统文理、3+3(综合)、3+1+2(物理/历史)等模式,并做常见表述纠错;未提及则不传该字段。
- 录取批次(luqupici)识别:对照
ref/luqupici_summary.json匹配批次简称;仅说「本科」或「专科」时按规则展开多类批次。 - 数据查询:调用
fetch_data.py,向https://gaokao.search.qq.com/skills_data请求type=province_score_line数据,再按用户意图过滤批次并总结回答。
安装与启用¶
SkillHub 提供两种常见方式,任选其一。
方式一:让 Agent 按官方安装文档执行¶
将下面提示词发给已支持 Skill 安装的客户端(文案来自 SkillHub 技能页):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@tencent-adm/tencent-yuanbao-gaokao-regional-passing-scores`。
安装文档要求:使用 skillhub install 时必须加 --dir,指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能无法被识别。
方式二:本机使用 skillhub CLI¶
先确认是否已安装 CLI:
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装(示例命令如下,以文档为准):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时把 --dir 换成你当前环境的路径。文档给出的常用目录包括:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
示例(将 <skills 目录> 替换为实际路径):
skillhub install tencent-yuanbao-gaokao-regional-passing-scores --dir <skills 目录>
也可先搜索再安装:
skillhub search 元宝高考通
skillhub install tencent-yuanbao-gaokao-regional-passing-scores --dir <skills 目录>
启用后,在对话中提及各省分数线、批次、位次等问题时,Agent 应加载该 Skill 并按 SKILL.md 的流程处理。
典型用法¶
自然语言(推荐)¶
在已启用 Skill 的 Agent 中直接提问,例如:
- 「福建 2024 年历史类本科批分数线和排名」
- 「上海今年综合类普通本科录取线」
- 「广西近一年专科批最低分」
Agent 会依次提取 place、year、student、luqupici,再调用包内脚本;若无法识别省份,Skill 要求向用户确认:「您想查询哪个省份的信息呢?」
直接调用查询脚本¶
需要在 Skill 包根目录下执行(相对路径 ./ref/、./fetch_data.py 均以此为准)。fetch_data.py 文件头注释中的示例如下:
python3 ./fetch_data.py --place 福建 --year 2024 --student 历史 物理
SKILL.md 中的通用形式为:
python3 ./fetch_data.py --place {place...} --year {year...} --student {student...} --luqupici {luqupici...}
脚本会访问高考检索接口并输出可供 Agent 汇总的数据;运行环境需已安装 Python 3,且能访问外网。
适用场景与注意¶
适合谁
- 在 Cursor、Claude Code、Codex 等客户端里做志愿参考、批次说明的开发者或运营,希望答案与结构化数据一致而非纯推测。
- 需要按省份、年份、选科模式区分查询的教育类 Agent 产品。
限制与注意
- 数据以接口返回为准,年份覆盖与字段以腾讯高考检索服务实际响应为限;未传年份时行为由脚本与接口共同决定,提问时尽量写清年份更稳妥。
- 选科名称随省份高考改革年份变化,Skill 内附有改革时间表,Agent 需结合地区与年份做映射,用户表述不规范时依赖 Skill 的纠错规则。
requires_api_key=false指 SkillHub 侧不要求额外 Key;查询仍依赖在线接口,离线环境无法拉数。- SkillHub 页面统计(截至资料抓取):评分 100000,下载 2387 次;与商店展示一致即可,不作为录取政策依据。
结尾¶
「元宝高考通-地区分数线查询」把地区、年份、选科、批次四类槽位和脚本查询绑在一起,适合在 Agent 对话里做可核对的高考分数线检索。安装与优先源说明见 SkillHub 安装文档;技能详情与安装提示词见 SkillHub 技能页,API 入口为 https://api.skillhub.cn/tencent-adm/tencent-yuanbao-gaokao-regional-passing-scores。