前言¶
在 Agent 裏改倉庫，常見情況是模型一邊分析一邊寫文件：方案還沒對齊，diff 已經落地。回滾、對照需求、補測試都會變貴。若你希望 Agent 先把任務拆清楚、把風險寫明白，並在你點頭之後再改代碼，就需要一條可重複的「規劃門禁」。下面介紹 SkillHub 社區技能 計劃模式 plan-mode（@user_5607203c/plan-mode），用 /plan 觸發，把會話約束在「先規劃、後執行」的只讀分析流程裏。
這是什麼¶
計劃模式 plan-mode 是發佈者 user_5607203c 在 SkillHub 上架的社區 Skill（分類 ai-agent，版本 1.0.0，標籤 requires_api_key=false）。它解決的是：在用戶未明確批准前，Agent 不應執行任何會修改倉庫或環境的操作；必須先輸出結構化計劃，等用戶確認後再進入實施。
與「直接讓模型改代碼」相比，該 Skill 把 PLAN MODE 寫進技能說明：觸發後默認只讀分析，修改類操作需等批准。
核心功能¶
依據 SkillHub 頁面與 API 資料，已覈實能力如下。
- 觸發方式：用戶輸入
/plan時啓用本 Skill 所定義的 PLAN MODE。 - 先規劃、後執行：在 PLAN MODE 下爲只讀分析模式；須先完成規劃輸出，再考慮執行。
- 計劃結構：批准前須輸出完整計劃，包含：
- 任務理解
- 上下文分析
- 實施計劃
- 風險點
- 驗證方案 - 批准門禁：須等待用戶明確批准後，才能執行任何修改操作（寫文件、改配置、跑會改狀態的命令等，以技能約束爲準）。
安裝與啓用¶
SkillHub 提供兩種常見安裝路徑：把安裝提示交給支持 Skill 的 AI 客戶端，或使用 skillhub CLI 裝到當前 Agent 的 skills 目錄。
方式一：通過 AI 安裝（官方頁面提示）¶
將下面意圖發給當前 Agent（安裝步驟以 SkillHub 文檔爲準）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5607203c/plan-mode`。
方式二：skillhub CLI¶
先確認 CLI 是否可用：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（示例來自官方 skillhub.md）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，可能不會被客戶端加載。常用路徑示例（摘自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
將座標 @user_5607203c/plan-mode 安裝到對應目錄，命令形態如下（請將 <skills 目錄> 換成上表路徑）：
skillhub install @user_5607203c/plan-mode --dir <skills 目錄>
安裝後按你所用客戶端的慣例刷新或重啓，使 Skill 被加載。本 Skill 不要求 API Key。
典型用法¶
下面是一條可復現的會話流程，對應官方簡介中的觸發與門禁說明。
- 在已加載該 Skill 的 Agent 中，對具體任務先輸入
/plan，並說明目標（例如：重構某模塊、加接口、修缺陷）。 - 等待 Agent 在 PLAN MODE 下輸出完整計劃，覈對五部分是否齊全：任務理解、上下文分析、實施計劃、風險點、驗證方案。
- 若計劃有誤或範圍過大，在同一模式下補充約束，要求修訂計劃；仍不應在未批准前看到倉庫被修改。
- 用明確措辭批准（例如「按該計劃執行」），再讓 Agent 進入實施階段。
示例（用戶側輸入，僅作觸發演示）：
/plan
請爲當前項目增加健康檢查接口，不要先改代碼，先給完整計劃。
批准前 Agent 應停留在分析與規劃；批准後纔可進行修改類操作。
適用場景與注意¶
適合誰
- 需要在改代碼前對齊範圍、步驟與驗證方式的開發者。
- 高風險變更（數據庫遷移、權限、發佈腳本）希望先過一遍風險與驗證清單的團隊。
- 希望減少「Agent 擅自改文件」、便於 Code Review 前置的閱讀場景。
限制與注意
- 本 Skill 約束的是 Agent 在 PLAN MODE 下的行爲；用戶若在批准後仍發送模糊指令，實施階段仍可能偏離計劃，批准時宜寫清邊界。
- 只讀分析依賴客戶端與模型對 Skill 的遵守程度；關鍵環境仍建議配合分支保護與 CI。
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 959 次；社區來源，維護節奏以發佈者頁面爲準。
- 與 IDE 內置「Plan / 計劃」類模式若並存，以你實際加載的 Skill 與客戶端規則爲準，避免混用不同入口。
結尾¶
計劃模式 plan-mode 把 /plan 與「完整計劃 + 明確批准」綁在一起，適合「先想清楚再動手」的 Agent 協作。需要安裝或查看說明時，可打開 SkillHub 頁面：
- https://www.skillhub.cn/skills/user_5607203c/plan-mode
- https://api.skillhub.cn/user_5607203c/plan-mode
