前言¶
在 Cursor、Claude Code 等 Agent 裏處理跨多輪、多文件的任務時,常見問題是範圍在對話裏逐漸漂移:上一輪說好的驗收標準下一輪被忘掉,中間步驟也沒有可對照的落盤記錄。靠純聊天記進度,重啓會話或換模型後很難續上。
下面介紹 SkillHub 上的社區 Skill @user_fccf428b/planning(展示名:複雜任務範圍、步驟與驗收計劃制定|簡詩 AI)。它面向「先定範圍與步驟、再執行、並能跟蹤進度」這類需求,通過創建並維護持久的 Markdown 規劃文件,把任務結構化下來,供 Agent 按規劃執行。
這是什麼¶
一句話定位:爲結構化任務執行創建並管理持久的 Markdown 規劃文件。
- 座標:
@user_fccf428b/planning - 版本:1.0.0
- 分類:business-ops(SkillHub)
- 發佈者:user_fccf428b(Skill 名稱中帶「簡詩 AI」)
- 來源:community
- 是否需要 API Key:
requires_api_key=false(SkillHub 標籤)
官方簡介(英文,SkillHub 原文)說明適用時機:當用戶要求「create a plan」「track progress」「start a research project」,或出現與規劃、進度跟蹤相關的業務場景時,可啓用該 Skill。
SkillHub 頁面:https://www.skillhub.cn/skills/user_fccf428b/planning
安裝說明入口:https://skillhub.cn/install/skillhub.md
核心功能¶
依據 SkillHub 已公開描述,可覈實的能力如下:
- 創建規劃:爲當前任務生成並維護 Markdown 形式的規劃內容(範圍、步驟、驗收等由 Skill 內規則驅動,具體字段以安裝後的
SKILL.md爲準)。 - 持久化:規劃寫在文件裏,而不是隻留在對話上下文中,便於長任務、多輪執行時對照。
- 進度跟蹤:與「track progress」類請求配合,在既有規劃文件上更新或覈對執行狀態。
- 研究類項目入口:用戶提出「start a research project」或同類需求時,可用同一套規劃文件機制組織調研與交付步驟。
未在公開頁面單獨列出的能力(例如具體文件名、目錄結構、子命令)本文不展開,避免與真實 Skill 內容不一致。
安裝與啓用¶
SkillHub 推薦方式:讓 Agent 按 SkillHub 安裝文檔 安裝本 Skill。頁面對應提示爲:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_fccf428b/planning`。
1、安裝 SkillHub CLI(若尚未安裝)¶
先檢查是否已有 CLI:
command -v skillhub && skillhub --version
未安裝時,可用官方腳本(完整安裝含默認 Skill;僅需 CLI 時加 --cli-only):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄;默認裝到 ./skills/ 可能不會被識別。
skillhub install user_fccf428b/planning --dir <你的 skills 目錄>
常用路徑(摘自 SkillHub 安裝文檔,按你實際使用的客戶端選擇):
| 客戶端 | skills 目錄(示例) |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目下 .windsurf/skills/ |
安裝後若客戶端要求重啓或重新加載 Skills,按其產品說明操作。
典型用法¶
公開資料未附帶完整 SKILL 正文,下面是可以直接復現的觸發方式與預期行爲(與簡介一致):
-
新建計劃
在對話中明確說要「制定計劃」「create a plan」,並描述任務目標。Agent 在啓用該 Skill 後,應傾向於生成或更新 Markdown 規劃文件,而不是隻在回覆裏列一遍清單。 -
跟蹤進度
執行過程中說「跟蹤進度」「track progress」,或要求對照計劃檢查完成情況。預期是在已有規劃文件上反映當前狀態(具體寫法由 Skill 規則定義)。 -
啓動研究項目
使用「start a research project」或中文等價表述(例如「開始一個調研項目並做計劃」),用同一套持久化規劃機制組織步驟與驗收。
若需覈對規劃模板、文件命名或更新流程,請在安裝後閱讀技能包內的 SKILL.md。
適用場景與注意¶
適合誰
- 需要把「範圍、步驟、驗收」寫清楚再讓 Agent 執行的一線開發、產品或運營同學。
- 任務會跨多輪對話、多文件改動,希望有一份可打開的 Markdown 作爲單一事實來源。
- 分類爲 business-ops,偏業務流程與執行管理,而非單一代碼片段生成。
注意
- 本 Skill 不需要 API Key;仍須正確安裝到 Agent 的 skills 目錄。
- 社區來源(community),版本當前爲 1.0.0;升級可用
skillhub的 install/update 流程,並繼續指定--dir。 - SkillHub 統計(抓取時點):評分 100000,下載 1378;以 SkillHub 頁面實時數據爲準。
- 規劃質量取決於你對目標、邊界和驗收標準的描述;Skill 負責結構化與持久化,不能替代你對業務範圍的判斷。
結尾¶
@user_fccf428b/planning 解決的是複雜任務在 Agent 對話裏「計劃易丟、進度難對齊」的問題:用持久 Markdown 規劃文件承載範圍、步驟與驗收,並在 create plan、track progress、research project 等場景下由 Agent 按 Skill 規則維護。
安裝與優先源配置:https://skillhub.cn/install/skillhub.md
Skill 詳情頁:https://www.skillhub.cn/skills/user_fccf428b/planning