gaokao-zhiyuan

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

执行前检查：在正式流程前，确保数据层就绪：

# 1. 初始化数据库（首次运行或数据库丢失时）
python gaokao-data-service/main.py init

# 2. 检查省份覆盖
python gaokao-data-service/main.py query --domain coverage

# 3. 本阶段只验收广东物理类；如果广东无数据，爬取
python gaokao-data-service/crawler/baidu_api.py --provinces 广东 --years 2024 2023 2022

# 4. 校验数据质量
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	数据索引+报告生成	✅