@wujiaming/gaokao-zhiyuan

面向全国所有省份的通用高考志愿填报建议器 —— 一个 Agent Skill（SKILL.md 格式）。

A universal China Gaokao college-application advising Agent Skill. Ships SKILL.md + references/ so any agent that supports the Agent Skills format (Claude Code, OpenClaw, etc.) can load it.

这是什么

输入考生分数 + 省份 + 科类 + 全省位次 + 偏好，输出一份默认保守的冲/稳/保三档志愿建议 + 可直接录入本省志愿系统的草表。

• 🧭 省份快速学习协议：面对任意省份，用固定 12 项「规则卡」+ 固定检索动作现查现学该省当年规则，再套统一推演引擎 —— 不硬编码某一省。
• 🛡️ 默认保守：冲靠前 3%~8% / 稳 −3%~+5% / 保靠后 8%~25%，稳+保占 80%，严防滑档。
• 📝 可直接录入草表：逐行对应官方志愿系统志愿位（模式 A 院校专业组 / 模式 B 专业+院校）。
• 🔬 零杜撰：数据强制官方源 + 历年 + 多源交叉验证；位次锚定、线差双锚点、专业组真实位次。

⚠️ 这是一个 prompt/方法论形态的 Agent Skill（Markdown 文档，非可执行 JS 库）。npm 在这里只是分发载体。安装 = 把 skill 文件拷进你 agent 的 skills 目录，再由 agent 自行加载。

快速安装

# 自动探测目标 agent 的 skills 目录并安装
npx @wujiaming/gaokao-zhiyuan

# 指定平台
npx @wujiaming/gaokao-zhiyuan --target claude          # ~/.claude/skills/gaokao-zhiyuan
npx @wujiaming/gaokao-zhiyuan --target claude-project  # ./.claude/skills/gaokao-zhiyuan
npx @wujiaming/gaokao-zhiyuan --target openclaw        # ~/.openclaw/skills/gaokao-zhiyuan

# 自定义目录
npx @wujiaming/gaokao-zhiyuan --dir /path/to/your-agent/skills

# 只打印包内 skill 路径（自己拷）
npx @wujiaming/gaokao-zhiyuan --print

各平台接入指南

Claude Code（Anthropic Agent Skills）

1. npx @wujiaming/gaokao-zhiyuan --target claude（用户级）或 --target claude-project（项目级）
2. 重启 Claude Code，它会自动发现 skills/gaokao-zhiyuan/SKILL.md
3. 触发：让 Claude「帮我做高考志愿填报」即可命中

OpenClaw

1. npx @wujiaming/gaokao-zhiyuan --target openclaw，或直接 clawhub install gaokao-zhiyuan（推荐，已上架 ClawHub）
2. 重载 gateway，skill 即出现在技能目录

Codex / Hermes / 其他 agent

这些平台目前没有统一的 skill 自动加载标准。两种用法：

• 作为系统提示/上下文注入：把 skill/SKILL.md 内容（必要时连同引用的 references/*.md）作为 system prompt 或上下文喂给模型。
• 手动放置：npx @wujiaming/gaokao-zhiyuan --dir <你的skills目录>，再按你的框架约定加载。

路径约定不同，请按你的 agent 文档把 SKILL.md 接成它认识的入口。

包内结构

skill/
├── SKILL.md                              # 入口（主流程 + 红线 + 输出门控）
└── references/
    ├── province-onboarding-protocol.md   # 省份快速学习协议（通用性根基）
    ├── methodology-rank-anchor.md        # 位次锚定推演法（保守口径）
    ├── system-entry-format.md            # 志愿系统录入格式（A/B 草表）
    ├── province-rules.md                 # 各省志愿规则框架
    ├── cross-verification-protocol.md    # 多源交叉验证 + 数据陷阱
    ├── data-source-registry.md           # 官方数据源登记
    ├── value-maximization.md             # 价值最大化（优化层）
    ├── output-template.md                # 输出模板
    └── pitfalls-checklist.md             # 出表前自检清单

重要声明

• 本 skill 提供方法论与流程，所有院校/分数/位次/代号数据需由 agent 现查现核当年官方源；skill 本身不内置任何院校录取数据。
• 志愿规则、代号、批次每年微调，使用时一律以考生当年本省官方文件为准。
• 仅供参考，最终志愿决策由考生与家长负责。

其他渠道

• ClawHub：clawhub install gaokao-zhiyuan（latest 1.3.0）
• 源码仓库：https://github.com/wujiaming88/skills/tree/main/gaokao-zhiyuan

License

MIT © wujiaming88