「嚴謹」的 AI Agent 工作流程
分享在網路上看到別人對 AI Agent 的工作流程
作者使用 Claude code 已經九個月了,他建立的工作流程有一個核心原則:
「在看過並同意書面計畫之前,不要讓 Claude 編寫程式碼。」
工作流程(重複 1-6 次)
研究 (Research)
規劃 (Plan)
標註 (Annotate)
待辦清單 (Todo List)
實作 (Implement)
回饋與迭代 (Feedback & Iterate)

研究(Research)
要求 Claude 在做任何事之前,先徹底理解 codebase 的部分
範例提示詞:
深入閱讀這個資料夾,透徹理解它的運作方式、功能以及所有特性。完成後,在 research.md 中寫一份詳細的研究報告。詳細研究這個系統,理解裡頭複雜的地方,並撰寫一份包含所有運作細節的 research.md。檢查任務調度流程,深入了解並尋找潛在 Bug。系統中肯定有 Bug,因為有時應該被取消的任務卻執行了。持續研究流程直到找到所有 Bug 為止。完成後,在 research.md 中寫下詳細發現。作者說這個research.md很重要。可以透過research.md ,讓使用者驗證 Claude 是否真的理解了系統,並在規劃開始前糾正誤解。
規劃 (Plan)
審查完研究結果後,要求在另一個 Markdown 文件裡頭制定詳細的實作計畫。
範例提示詞:
我想建立一個新功能 <名稱與描述>,擴增系統以實現 <功能>。請編寫一份詳細的 plan.md 文件說明如何實作,並包含程式碼片段。生成的計畫應包含:詳細的做法、顯示實際更改的程式碼片段、將要被修改的文件路徑,以及折衷方案(trade-offs)。
標註 (Annotate)
Claude 編寫
plan.md。在編輯器中審查。
直接在
plan.md中加入行內筆記 (Inline notes)。請 Claude 帶回
plan.md並更新計畫。如果不滿意,重複上述步驟;如果滿意,要求待辦清單(Todo list)。

待辦清單 (Todo List)
建立一個清單,在實作期間可以追蹤進度。Claude 會在執行過程中標記已完成的項目,方便隨時掌握進度。
範例:
在計畫中加入詳細的待辦清單,包含完成計畫所需的所有階段和個別任務 —— 先不要實作。實作 (Implement)
當一切準備好了,作者說他會輸入一個標準的實作提示詞:
全部實作。當你完成一個任務或階段時,在計畫文件中將其標記為已完成。在所有任務和階段完成前不要停止。不要添加不必要的註解或 JSDoc,不要使用 any 或 unknown 型別。持續運行型別檢查(typecheck)以確保你沒有引入新問題。回饋與迭代 (Feedback & Iterate)
一旦 Claude 開始執行計畫,作者說他的角色就轉變為監督者。使用的提示詞會變得非常簡短,持續修改直到滿意為止就完成了。
範例:
你沒實作 deduplicateByTitle 函式。你把設定頁面寫在主程式,應該在後台管理程式(admin app)裡,搬過去。再寬一點還是被裁切了這裡有 2px 的間隙
總結這個工作流
深入閱讀,編寫計畫,更改計畫直到滿足你要的需求和成果為止,然後讓 Claude 在不間斷的檢查下執行到底。
還沒試過這個方法,但先分享給大家,期望會有幫助~~
作者:小緯