m_plan — 將請求轉為計劃文檔
不進行實作。目標是建立一份其他代理能直接依此實作的具體計劃。
輸入
- 如果技能接收的參數是存在的檔案路徑,則該檔案內容即為請求。否則,整個參數(可包含多行)即為請求。
- 如果參數為空,則詢問使用者想開發什麼。
流程
- 理解:讀取請求,並檢查相關的既有程式碼與文檔(
AGENTS.md、plan/README.md、可重複使用的程式碼)。 - 決定 ID:選擇最能代表計劃內容的英文大寫三字元縮寫(例如
FKS= Foreign film Korean Subtitle)。確認plan/README.md中無重複。 - 前提驗證:對於計劃依賴的不確定技術前提,透過簡短實驗進行驗證(檢查 CLI 選項是否存在、外部網站/API 是否可存取、回應時間等)。將驗證結果與日期記錄在計劃中。避免基於猜測制定計劃。
- 撰寫:使用下方範本建立
plan/<ID>_plan_<代理>-<模型>.md(作者標示依據AGENTS.md),並在plan/README.md索引表中新增一行| <ID> | <計劃名稱> | 計劃中 |。 - 確認決策:將需要決定的事項標記為
<ID>-Q1、<ID>-Q2……,並一次一個向使用者提問。- 每個問題提供 2~3 個選項,並為推薦選項標示
(推薦)並附上理由。 - 如果使用者回答不在選項中,則透過實驗確認可行性,告知結果並納入計劃。
- 得到回答後,以
✅標記為已確認,並根據該決定修正內容中的相關部分。
- 每個問題提供 2~3 個選項,並為推薦選項標示
- 完成:當所有決策都已確認,將索引狀態改為
計劃確認(實作前),並詢問是否要提交。指引下一步為/m_impl <ID>。
範本 (plan/<ID>_plan_<代理>-<模型>.md)
# [<ID>] <計劃名稱>
## 1. 目標
<做什麼、為什麼做。也需明確說明不涵蓋的範圍>
## 2. 整體流程
<處理順序與優先級。必要時使用圖表>
## 3. 步驟詳細說明
### 1) <步驟>
- <具體方法、使用的命令/API/格式、失敗時的處理方式>
## 4. 共用模組
<多個步驟共用的部分:輸入輸出格式、外部工具呼叫、快取、錯誤處理>
## 5. 實作結構
- 檔案結構、可重複使用的既有程式碼、依賴原則、設定方式
- CLI/用法草案
## 6. 決策事項
- **<ID>-Q1** <問題> — 選項 … (確認後 `✅ <決定內容>`)
## 7. 里程碑
| # | 內容 | 完成標準 |
| :--- | :--- | :--- |
| <ID>-M1 | … | <可驗證的標準> |