前言¶

考研、国考省考、事业编等备考，常见做法是列一张科目清单，再按周手写复习表。一旦官方考试日确定，或中途调整每日可学时长，整张表往往要重算：还剩多少天、基础/强化/冲刺各占多久、模考该落在哪些周末。手工倒排既费时，也容易在阶段边界和周任务量上前后不一致。

下面介绍 SkillHub 上的社区 Skill「考试倒计时规划」（坐标 @user_70c2f807/exam-countdown-planner）。它把「考试日期 + 每日投入时长」转成本地可计算的倒排骨架，再由 Agent 结合参考文档拆到科目与每周任务，适合已经用 Cursor、Claude Code 等支持 Skills 的客户端、希望用对话生成可执行备考时间表的场景。

这是什么¶

「考试倒计时规划」是 SkillHub 分类 education 下的社区 Skill，发布者为 user_70c2f807，当前版本 1.0.0，来源标注为 community。Skill 包内标识为 exam-countdown-planner，展示名在 SKILL 元数据中为「考研公考日程倒排」，与商店页名称一致指向同一能力。

它解决的是时间维度的倒排：给定考试日（及可选的考试类型、每日小时数），计算剩余天数与周数，按通用比例切分基础 / 强化 / 冲刺三阶段，输出各阶段起止日期、周均学习时长、冲刺期全真模考节点与倒计时里程碑。核心计算由随 Skill 附带的 scripts/exam_plan.py 在本地完成，不调用外部接口；SkillHub 标签为 requires_api_key=false。

官方页面：https://www.skillhub.cn/skills/user_70c2f807/exam-countdown-planner

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与 references/phase-guide.md，安装后可自行核对。

1. 倒排时间轴：从考试日反推「今天」到考试日的剩余天数、周数，并划分基础（默认约 50%）、强化（约 30%）、冲刺（约 20%）三阶段起止。
2. 周均任务量：按用户给出的每日可投入小时数（默认 5 小时），结合阶段强度系数，给出各阶段周均学习时长，供后续拆到科目。
3. 模考与里程碑：在冲刺阶段按规则安排全真模考日期（如每 14 天一次、考前约 3 天最后一次模考），并列出「今天 / 基础结束 / 强化结束 / 考试日」等倒计时节点。
4. 考试类型分支：支持 考研 与 公考 两类；科目级重点与周任务拆解需结合 references/phase-guide.md（数学/英语/政治/专业课或行测/申论等）。
5. 风险与提醒：剩余天数少于 21 天、考试日已过、或时间充裕但投入偏低等情况，脚本会给出 warns/risks，退出码用于 Agent 提示用户调整。

Skill 明确边界：只做时间倒排与阶段任务规划，不提供知识点押题、报班或择校建议；考试日以用户输入为准，脚本不联网核对当年公告。

安装与启用¶

方式一：SkillHub CLI（推荐）¶

先确认本机已安装 skillhub（安装方式见 SkillHub 安装文档）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端加载。

在 Cursor 中，常用路径为 ~/.cursor/skills/：

skillhub install @user_70c2f807/exam-countdown-planner --dir ~/.cursor/skills/

其他客户端路径以官方文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。

方式二：让 Agent 按官方提示安装¶

SkillHub 页面提供的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_70c2f807/exam-countdown-planner。在对话中发送该说明，由 Agent 读取安装文档并执行等价步骤即可。

安装完成后，在支持 Skills 的客户端中启用或刷新技能目录（部分环境需重启客户端），Agent 在识别到备考倒排类意图时会加载本 Skill。

典型用法¶

对话触发¶

Skill 元数据建议的触发场景包括：用户要做考研、考公、国考省考、事业编等的备考计划、复习排期、倒计时规划、阶段划分、每周任务或模考安排；或询问「从今天到考试怎么倒排」「公考三阶段怎么分」「什么时候开始模考」等。示例表述：

用户：考研还有多久，从今天到 2026-12-26 怎么安排？
用户：帮我做个公考备考计划，每天能学 6 小时
用户：从今天到考试怎么倒排，什么时候安排全真模考？

Agent 侧流程（Skill 约定）¶

1. 收集输入：考试日期（必填，格式 YYYY-MM-DD）、考试类型（默认考研）、今日日期（默认系统当天）、每日可投入小时（默认 5）。
2. 运行本地脚本生成倒排骨架，例如：

python3 scripts/exam_plan.py --exam-date 2026-12-26 --type 考研 --hours 6

或使用配置文件：

python3 scripts/exam_plan.py --file config.txt
python3 scripts/exam_plan.py --file config.txt --json

配置文件为每行 key=value，字段包括 exam_date、type、today、hours。加 --json 时输出含 phases、mocks、milestones、warnings、risks 的结构化结果；--sample 可打印示例配置。

3. 按科目细化：将脚本给出的周均时长，结合 references/phase-guide.md 拆到各科与每周章节/题量。
4. 按固定结构交付，例如考试概要、三阶段计划、模考节点、倒计时里程碑、周任务拆解、提醒与风险等区块（详见 Skill 内「输出格式」一节）。

脚本依赖 Python 3 标准库，退出码约定：正常为 0；考试日已过或剩余天数过短为 1；输入格式错误为 2。

适用场景与注意¶

适合谁

• 已确定或暂定考试日，需要快速得到三阶段时间表与模考节点的考生。
• 使用 Cursor、Claude Code 等 Agent，希望通过自然语言反复调整「每日小时数」或考试类型并重算排期的人。
• 希望计算逻辑可本地复现、不依赖在线 API 的环境（requires_api_key=false）。

限制与注意

• 剩余天数 少于 21 天 时，Skill 说明不做完整三阶段倒排，倾向真题与模考；脚本会以退出码 1 提示风险。
• 阶段配比与强度系数为通用经验；在职、跨考等需在 references/phase-guide.md 基础上自行调整。
• SkillHub 页面显示评分 100000、下载约 990 次（截至资料抓取时）、安装计数为 0；社区 Skill，使用前可在商店页查看更新与说明。
• 计划仅为时间与任务量建议，实际进度需结合个人基础动态调整；严重时间不足或政策变动应以官方公告为准。

结尾¶

「考试倒计时规划」把考试日、每日投入与考试类型收敛成可执行的倒排框架：本地脚本负责天数与阶段切分，参考文档负责科目拆解，Agent 负责对话收集输入与格式化交付。若你正在用支持 Skills 的编码助手备考，可从官方页安装并试一次倒排：

https://www.skillhub.cn/skills/user_70c2f807/exam-countdown-planner