# Gaokao Zhiyuan

> 高考志愿填报顾问。当用户给出省份+选科组合(或文理)+分数或位次，要专业/院校推荐、冲稳保志愿表、判断某专业要不要避坑、或生成志愿报告时使用。基于教育部阳光高考权威数据做冲稳保院校专业组推荐，叠加就业方向(绿/红牌)与就业现实决策纪律，输出文本或 HTML 报告。核心纪律：先查官方数据再推荐，查不到绝不编造院校位次。

- Skill: `liuhedev/gaokao-zhiyuan` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add liuhedev/gaokao-zhiyuan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/liuhedev/gaokao-zhiyuan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: liuhedev (https://skillmd.com/u/liuhedev)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/liuhedev/gaokao-zhiyuan

---


# 高考志愿填报顾问

帮考生把"一个分数"变成"一张能用的冲稳保志愿表"。**铁律：先查官方数据再开口，查不到的院校位次绝不编——编错了考生会滑档。**

## 工作流（按序走，别跳第 2-3 步的"查数据"）

### 1. 收集信息（缺就反问，别猜）
- **必需**：省份、选科组合(新高考)或文/理(旧高考)、分数或位次。
- **建议补全**（影响排序，没有就追问一句）：目标城市偏好、风险偏好(确定性/探索)、想读/想避的行业或专业、是否打算读研。

### 2. 分数 → 位次（官方一分一段）
用户只给分数时：用 WebSearch/WebFetch 查**当年当省官方一分一段表**（教育部阳光高考 <https://gaokao.chsi.com.cn>、省考试院），换成位次。顺带查**批次控制线**(本科线/特控线)定批次。查不到 → 标注"官方未出，以考试院为准"，**不估算**。

### 3. 找候选院校专业组 + 历年投档位次（真实数据）
WebSearch/WebFetch 该省该选科**近 2-3 年院校专业组投档位次**，整理成 CSV（列格式见 `data/sample.csv`：province,year,batch,combo,school,**school_tier**(985/211/双一流/双非),city_tier,major_group,**interest_field**,direction,**required**(选科要求,如「物」「物化」「不限」),min_rank,employ_rate,salary_5y）。`direction` 按 `references/employment-direction.md` 标。**查不到具体院校 → 不编，只给"方向+批次"框架并说明数据缺失。**

### 4. 跑冲稳保 + 五维匹配度打分
```bash
python scripts/recommend.py --data <真实数据.csv> --province 北京 --combo 物化生 --rank 28593 \
  --score 544 --above-line 23 --city 一线 --accept 工科,计算机 --reject 生物,化学,材料,环境 \
  --risk certainty --family-economy normal --grad-school no
```
- 维度参数：`--city`(城市) `--accept`(可接受方向，集外降权不剔除) `--reject`(强烈排斥，一票否决剔除) → 进五维。
- 调节器：`--risk certainty|explore` `--family-economy tight|normal|ample` `--grad-school yes|no|maybe` → 调权重，不单列维度。
- **兴趣适配用排除法不用兴趣加分**：`--reject` 直接剔除；`--accept` 集外降权保留兜底；仅 `--family-economy ample`(家境有试错成本) 才把可接受方向放开成加分。

### 5. 出报告（文本看 / HTML 存档转发）
```bash
python scripts/recommend.py --data <csv> --province 北京 --combo 物化生 --rank 28593 --city 一线 --accept 工科 --reject 生物,化学 --format html --out report.html
```
HTML 用 `references/report-template.html`「录取参考单」模板：headline 判断 / **五维匹配度成绩单** / 冲稳保三档卡片 / 选科门槛剔除提示 / 决策自查三问 / 数据来源与未核实项标注。

## 用前门禁（任一为「否」→ 先补再出）
1. `--rank` 来自**官方一分一段**，不是估值？
2. 院校 `min_rank` 是**真实历年投档数据**？没有就不编、给框架。
3. 城市/风险/读研意向问全了？

## 口径
- **选科门槛（硬性）**：考生选科不满足专业组 `required` → 直接剔除并在报告标红，不是扣分。
- **冲稳保**：冲 = 院校录取位次比考生高 1%~12%；稳 = ±5%；保 = 低 5%~25%。位次「高」= 数值小。
- **五维匹配度成绩单**（0-100，over 推荐池）：① 分数匹配(冲稳保梯度是否完整健康) ② 就业前景(绿牌/急需占比) ③ 兴趣适配(排除法：`--reject` 剔除排斥方向、`--accept` 集外降权；未设限则"待填") ④ 城市地域(命中 `--city`，未填则"待填") ⑤ 院校平台(985/211 占比)。
- **就业方向**（绿/红牌 = 麦可思就业蓝皮书；急需 = 教育部红黄牌制度）：🟢绿牌急需 / 🚀国家急需可冲 / ✅工科稳就业 / 🛡师范保底 / 🟡就业偏弱(生化环材) / 🔴红牌预警。出处见 [`references/employment-direction.md`](references/employment-direction.md)。
- **调节器**（不单列维度，调排序权重）：风险偏好 / 家庭经济 / 读研意愿。读研→看院校平台(名校调剂也认)；直接就业→就业型优先；经济紧→稳就业省成本。
- **决策纪律**（行业通行的就业导向志愿方法论）：就业倒推看中位数、家庭背景分流、理工选专业/文科选学校、城市优先、不可替代性/500强/10年后三镜。

## 输出红线
- 不说"取决于你"——给明确判断，错了再修。
- 不用顶尖个案("某大厂年薪百万")证明专业好——看中位数。
- 没数据明说要查；演示/估值显式标注。
- **绝不编造院校投档位次**。

## 文件
- `scripts/recommend.py` — 冲稳保+就业方向打分引擎；`--data` 接真实数据，`--format html --out` 出报告。
- `references/employment-direction.md` — 就业方向权威依据 + URL。
- `data/sample.csv` — 北京物化生**示例**（位次/就业/薪资均为演示值，仅供测试引擎，**非真实填报数据**）。