前言¶
考研、國考省考、事業編等備考，常見做法是列一張科目清單，再按周手寫複習表。一旦官方考試日確定，或中途調整每日可學時長，整張表往往要重算：還剩多少天、基礎/強化/衝刺各佔多久、模考該落在哪些週末。手工倒排既費時，也容易在階段邊界和周任務量上前後不一致。
下面介紹 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，安裝後可自行覈對。
- 倒排時間軸：從考試日反推「今天」到考試日的剩餘天數、週數，並劃分基礎（默認約 50%）、強化（約 30%）、衝刺（約 20%）三階段起止。
- 周均任務量：按用戶給出的每日可投入小時數（默認 5 小時），結合階段強度係數，給出各階段周均學習時長，供後續拆到科目。
- 模考與里程碑：在衝刺階段按規則安排全真模考日期（如每 14 天一次、考前約 3 天最後一次模考），並列出「今天 / 基礎結束 / 強化結束 / 考試日」等倒計時節點。
- 考試類型分支：支持 考研 與 公考 兩類；科目級重點與周任務拆解需結合
references/phase-guide.md（數學/英語/政治/專業課或行測/申論等）。 - 風險與提醒：剩餘天數少於 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 約定）¶
- 收集輸入：考試日期（必填，格式
YYYY-MM-DD）、考試類型（默認考研）、今日日期（默認系統當天）、每日可投入小時（默認 5）。 - 運行本地腳本生成倒排骨架，例如：
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 可打印示例配置。
- 按科目細化：將腳本給出的周均時長，結合
references/phase-guide.md拆到各科與每週章節/題量。 - 按固定結構交付，例如考試概要、三階段計劃、模考節點、倒計時里程碑、周任務拆解、提醒與風險等區塊（詳見 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
