create-implementation-plan 是做什麼的?
為新功能、重構現有程式碼、升級套件、設計、架構或基礎設施建立新的實施計畫檔案。
概述
此技能協助開發者將規劃步驟文件化,產生包含目標、具體任務、相依性與時程的結構化實施計畫。計畫檔案遵循標準化格式,可整合至 GitHub 工作流程或由 AI 代理工具(如 Claude Code)解讀與執行。
使用方式
使用以下 CLI 指令(或透過 AI 代理觸發):
create-implementation-plan --type <plan-type> --description "<簡要說明>"
範例:
create-implementation-plan --type feature --description "新增使用者個人資料頁面"
支援的計畫類型
| 類型 | 說明 |
|---|---|
| feature | 新功能開發 |
| refactor | 現有程式碼重構 |
| upgrade | 套件或相依性升級 |
| design | 系統或 UI/UX 設計 |
| architecture | 軟體架構調整或定義 |
| infrastructure | 部署、CI/CD 或基礎設施變更 |
輸出格式
生成的檔案路徑範例:.github/plans/feature-add-user-profile.md
檔案內容包含:
- 標題:根據類型與說明自動產生
- 目標:明確陳述此計畫要達成的目標
- 任務清單:使用 Markdown 任務列表(
- [ ])列出具體步驟 - 相依性:列出需先完成的外部或內部相依項目
- 時程估計:建議時間範圍或里程碑
- 驗收條件:完成此計畫所需的條件清單
環境變數
PLANS_DIR:指定計畫檔案的存放目錄(預設為.github/plans/)DEFAULT_PLAN_TYPE:若未指定類型時的預設值(預設為feature)
注意事項
- 確保專案中存在
.github/plans/目錄,或透過PLANS_DIR變數指定其他路徑。 - 計畫描述應簡潔但足以讓他人理解意圖。
- 任務清單應保持可拆分且可實施的粒度。