| name | gaokao-zhiyuan |
| description | 高考志愿规划编排入口——依次调用6个子Skill完成从画像解析到报告生成的全流程 |
gaokao-zhiyuan:高考志愿规划编排 Skill
Codex 适配说明
- 在 Codex 中通过 $gaokao-zhiyuan 或 /skills 选择本技能。
- 解析 [[name]] 引用时,读取 ../../references/name.md。
- 优先使用本项目本地数据服务,查不到时才按数据来源优先级降级。
功能说明
编排层 Skill,按顺序调用 6 个领域子 Skill,完成从画像解析到报告生成的全流程。每个子 Skill 也可独立调用。
使用方式
$gaokao-zhiyuan
运行后提示用户提供画像文件路径,自动检测 .json 或 .md 格式并启动流程。
编排流程
Step 0:数据准备(新增)→ gaokao-data-service
执行前检查:在正式流程前,确保数据层就绪:
python gaokao-data-service/main.py init
python gaokao-data-service/main.py query --domain coverage
python gaokao-data-service/crawler/baidu_api.py --provinces 广东 --years 2024 2023 2022
python gaokao-data-service/main.py validate --province 广东
当前阶段边界:本轮默认只处理 province=广东、curriculum=3+1+2物理。广东物理类专业组数据覆盖不足则终止,提示规划师运行爬虫或手动准备数据;历史类和其他省份不作为本轮验收范围。
Step 1:画像解析 → $gaokao-profile
调用 gaokao-profile Skill,传入用户提供的文件路径。
- 输入:画像文件路径(JSON 或 MD)
- 输出:画像 JSON + 画像摘要 + 路径可行性表 + 矛盾点
- 缺失必填字段则终止全流程
Step 2:院校匹配 → $gaokao-match
将 Step 1 的画像 JSON 传给 gaokao-match。
- 输入:画像 JSON
- 输出:排位密度判断 + 冲/稳/保推荐表 + 提前批/专项评估
- 数据查询优先级:本地
gaokao-data-service → 百度API实时查询 → WebSearch降级
- 广东物理类主查询命令应显式包含
--curriculum "3+1+2物理" 和考生选科:
python gaokao-data-service/main.py query --domain gaokao --province 广东 --year 2024 --rank <考生位次> --subject "<选科组合>" --curriculum "3+1+2物理"
- 如果投档线数据全部无法查到,终止并提示规划师手动准备数据
- 招生计划或一分一段表缺失时不中断,但必须在中间产物和报告中标注
招生计划待确认 [无来源]、排位密度待确认 [无来源]
Step 3:中外合办 → $gaokao-sino-foreign
将画像 JSON 传给 gaokao-sino-foreign。
- 输入:画像 JSON
- 输出:计划内/计划外合办推荐表
- 如果预算不支撑任何合办路径,输出"不适用"说明
Step 4:留学+曲线 → $gaokao-abroad
将画像 JSON 传给 gaokao-abroad。
- 输入:画像 JSON
- 输出:留学推荐表 + 曲线路径方案
- 如果预算不支撑留学,跳过留学部分仅输出曲线路径
Step 5:风险审查 → $gaokao-risk-check
汇总 Step 2-4 的所有推荐方案,传给 gaokao-risk-check。
- 输入:全部推荐表 + 画像摘要
- 输出:风险检查清单 + 决策对比矩阵 + 行动清单
- 任一检查项不通过 → 暂停,标注问题并提示规划师调整方案后重新执行
Step 6:报告生成 → $gaokao-report
汇总 Step 1-5 的全部产出,传给 gaokao-report。
- 输入:全部中间产物
- 输出:完整的志愿推荐报告 Markdown 文件
- 文件路径:
志愿推荐报告_{姓名}_{日期}.md
交互约定
画像文件确认
请提供考生画像文件路径:
> <用户输入路径>
检测文件扩展名:
.json → "检测为 JSON 模式,开始解析画像..."
.md → "检测为采集表模式,开始自动提取和转换..."
- 其他 → "不支持的文件格式,请提供 .json 或 .md 文件"
- 文件不存在 → "文件不存在,请检查路径"
进度提示
[1/6] 画像解析中...
[2/6] 院校匹配中...
[3/6] 中外合办评估中...
[4/6] 留学路径分析中...
[5/6] 方案风险审查中...
[6/6] 生成推荐报告...
完成确认
✅ 报告已生成:./志愿推荐报告_{姓名}_{日期}.md
📋 下一步:
1. 审查报告中标注"待确认 [无来源]"的数据项
2. 抽查 3 个推荐专业组的选科匹配
3. 确认风险检查清单全部通过
4. 将报告发送给考生/家长
💡 如需调整方案,修改画像文件后重新运行 $gaokao-zhiyuan
错误处理
| 场景 | 处理方式 |
|---|
| 画像解析必填字段缺失 | 终止全流程,列出缺失项 |
| 投档线数据全部无法查到 | 终止,提示规划师准备数据后重试 |
| 部分投档线数据缺失 | 标注"待确认 [无来源]",继续执行 |
| 招生计划缺失 | 标注"招生计划待确认 [无来源]",不得当作无风险 |
| 一分一段表缺失 | 标注"排位密度待确认 [无来源]",按中等密度默认配置 |
| 风险检查不通过 | 暂停,标注问题项,提示调整方案 |
| 选科组合无法匹配任何专业组 | 提示选科限制,给出可报范围说明 |
| 预算无法覆盖任何推荐 | 提示预算限制,标注"无匹配方案" |
子 Skill 清单
| Skill | 职责 | 可独立运行 |
|---|
| gaokao-profile | 画像解析(JSON/MD双模式) | ✅ |
| gaokao-match | 排位密度+常规批匹配+提前批 | ✅ |
| gaokao-sino-foreign | 中外合办匹配 | ✅ |
| gaokao-abroad | 留学+曲线路径 | ✅ |
| gaokao-risk-check | 风险审查+决策矩阵+行动清单 | ✅ |
| gaokao-report | 数据索引+报告生成 | ✅ |