前篇文章提到，everything-wp 內建多種 Command 可以讓開發者根據實際要製作的功能，選擇對應的指令來請 AI 開發，像是要設計自訂資料表就用 /custom-table、建立設定頁用 /option-page，進而精準地開發出符合 WordPress 規範的程式碼。
無開發經驗的規劃方法
但對一般比較不熟悉程式碼的朋友來說，要使用哪一個指令、哪一個 Command 讓 AI 進行開發，就會是一個難題。另一方面，我發現自己在使用 AI 進行開發時，一開始也是想到什麼就叫 AI 做什麼，但後來發現很多事情會重複執行，並造成程式架構的混亂。
關於這個問題，目前市面上已經有不少解決方案，例如：前陣子很火紅由 AWS 開發的 Kiro 編輯器，或是使用設計好的 Command、Skill，把整個規劃流程進行拆解與分析的開源專案，像是 OpenSpec。
像我自己就嘗試過模仿 Kiro 的開發流程，它的每個步驟都非常嚴謹。從規劃到需求分析、撰寫使用者故事、拆解開發清單，每一個開發步驟都必須要前一個流程手動審核通過後，才可以正式進入下一個階段的開發。
對我來說，如果是一個全新的專案，使用這個開發流程會非常完整，但缺點就是會很耗 Token，但假設我只是想要調整一些小功能，或是有一些功能在初期規劃完之後要再做修改，這樣子的流程反而會變得綁手綁腳。
因此我就在思考，有沒有更彈性的方式，可以把每一個功能規劃的流程處理得更靈活一點？我的需求時我希望在規劃階段，AI 就能參考我提供給它的文件，讓產出的內容可以更貼近實際需求。
規劃 Agent 的工作流程
在拆解任務的時候，同時請 AI 去尋找既有的開發 Command，就可以不用去費心研究每一個指令的用途，就能自動匹配到相對應的代辦事項之中。因此我根據之前實際進行新專案時拆解需求的方法，設計了一個「規劃 Agent」。它會從使用者提出的需求出發，進行以下拆分，主要會劃分大功能，然後每個大功能會包含子功能，子功能再列出執行細項，例如：
- 設計資料庫結構與自訂欄位
- 後台操作介面設計
- 前台介面設計
- 前後台的資料串接
這個規劃 Agent 可以根據需求，把每一個項目拆解成執行清單，然後再透過「執行 Agent」把這些需求文件交給它執行。規劃與執行 Agent 在每次執行前會先掃描既有的程式碼架構，藉此確保任務的執行進度，以及目前的程式碼是否有可重用或是模組化的地方。
假我的需求是：在客戶結帳完成後，能夠發送訊息到管理員的 Telegram 裡面。有了這樣的需求之後，我們人類要做的就是先準備好材料給它。以這個需求為例，首先我們要給它 WooCommerce 相關的 Hook 以及 Telegram 的技術文件。
我自己的習慣是會把對應的文件，使用 Skill Seeker 這個套件來請它整理成 Skill，這個套件可以把官方文件的所有頁面爬下來以外，並整理成完整的 Skill 搭配範例程式碼。接下來我只要使用斜線 plan 就能呼叫「規劃 Agent」並把上面的需求告訴它，然後標記 WooCommerce 以及 Telegram 的 skill，像是：
/plan 我要做一支外掛在客戶結帳完成後，能夠發送訊息到管理員的 Telegram 裡面 @./claude/skill/woocommerce @./claude/skill/telegram如果今天已經有一個現成的工具做到這些功能，也可以直接把該工具的網址貼進去，請 AI 研究後再進行規劃。透過這個指令規劃出來的待辦項目會有三個結構：
- 在外掛的根目錄新增 spec 資料夾，用來存放這些 AI 所產出來的主要規格
- spec 資料夾裡面會以資料夾區分主要的大功能，大功能的資料夾底下會有子功能的 Markdown 文件。
- 子功能的文件裡面會提到：這個功能的使用者故事、開發清單、需要參考的程式碼以及對應的 command。
這樣子使用者就可以在不需要理解每個 Command 的情況下，請 AI 來自行判斷要用哪一個指令來實際進行開發。每次「規劃 Agent」 在進行規劃的時候，會先去掃描目前的檔案內容，藉此確保他的規劃項目是對整體專案有一定程度的理解，進而避免開發出重複或是衝突的程式。
文件撰寫完成後，只要逐一檢查規則文件，確保它規劃的方向與我的需求相符。如果發現有錯誤或是需要修改的地方，我就直接把文件丟到 AI 裡面，請它再幫我進行修改。
執行 Agent 的工作流程
等到其中一份文件檢查完成之後，我就會啟動「執行 Agent」來根據此份文件的內容進行開發，執行 Agent 在每次開發前，都會先掃描目前的資料夾結構，以再次確保專案的程式碼架構。
另外也可以在執行的時候，指定所需的 Skill，讓它有更完整的上下文來進行程式碼的設計。等它開發完成後，它會去自動更新開發文件裡面的待辦事項，具體使用方式如下：
/todo @spec/o1-database/create.md依照這個邏輯，當我在開發新專案的時候，我可以先把跟 AI 討論的相關規格全部一次餵給它，讓它幫我整理出所有的開發文件，實際開發時，如果我想到一個新的功能，我一樣可以用「規劃 Agent」來新增任務，並且請它整理出開發清單。
每份開發文件都是一個相關功能的描述，因此理論上，有一些開發需求會是重複的，這樣就可以把開發文件轉移到其他項目後繼續使用，省去全部重新規劃的時間，目前我陸續開始把這樣的工作流程，導入到新的專案之中。
小結
從 AI 規劃出來的開發文件，可以很方便地直接拿來與客戶進行更具體且深入的討論。此外，後續如果要修改也具備高度彈性，不會因為必須遵守某些開發流程而讓自己綁手綁腳。
之後我會再把實務上會遇到的狀況整理進去。理想上，希望可以做到全部規劃完後就自動讓 AI 執行，我就不用再擔心執行的細節，雖然目前看來難度有點高，但我相信經過不斷的修正，並且設計新的 Skills 給 AI 後，理論上應該是可以達到這樣子的境界…吧？
下載 Agent
https://github.com/oberonlai/everything-wp
