gaokao-zhiyuan

name	gaokao-zhiyuan
description	高考志愿规划编排入口——依次调用6个子Skill完成从画像解析到报告生成的全流程
triggers	["/gaokao-zhiyuan"]

gaokao-zhiyuan：高考志愿规划编排 Skill

功能说明

编排层 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 <目标省份>

省数据覆盖不足则终止，提示规划师运行爬虫或手动准备数据。

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降级
• 如果投档线数据全部无法查到，终止并提示规划师手动准备数据

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 文件
• 文件路径：reports/志愿推荐报告_{日期}.md

交互约定

画像文件确认

请提供考生画像文件路径：
> <用户输入路径>

检测文件扩展名：

• .json → "检测为 JSON 模式，开始解析画像..."
• .md → "检测为采集表模式，开始自动提取和转换..."
• 其他 → "不支持的文件格式，请提供 .json 或 .md 文件"
• 文件不存在 → "文件不存在，请检查路径"

进度提示

[1/6] 画像解析中...
[2/6] 院校匹配中...
[3/6] 中外合办评估中...
[4/6] 留学路径分析中...
[5/6] 方案风险审查中...
[6/6] 生成推荐报告...

完成确认

✅ 报告已生成：./reports/志愿推荐报告_{日期}.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	数据索引+报告生成	✅