為什麼手動提示正在變成瓶頸
當工程師反覆輸入修正、貼錯誤、等輸出、再修正，其實是在人工扮演 代理 的控制器。
人變成工具接口
AI 程式助理 會寫碼，但每一輪何時重試、何時讀 紀錄、何時跑測試，仍由人手動驅動，效率卡在人身上。
提示詞 不是最小單位
真正可複用的單位不是一句提示，而是「任務拆解、工具權限、驗證條件、失敗處理」組成的流程。
工程師價值上移
低階程式碼轉譯會被自動化壓縮；會設計流程、驗收、回滾與 代理 協作的人，才是自動化流水線的架構師。
循環工程 的五段式框架
一個成熟閉環不是 while 循環，而是具備目標、狀態、行動、驗證與停止條件的工程系統。
定義目標
寫出可判定的完成狀態，例如 建置通過、測試通過、指定 API call site 全部遷移。
限制工具
明確允許讀檔、寫檔、測試、查文件；高風險指令需要人工或沙箱保護。
執行動作
代理 產生修改、跑命令、讀結果、更新計畫，而不是每一步等人下指令。
驗證回饋
用測試、程式檢查、建置、截圖、報告比對或 審核者 代理 產生 通過／失敗 訊號。
停止或升級
達標就停；連續失敗、權限不足、風險升高或證據不足時交還給人。
三層落地：從單一任務到多 代理 編排
先從最容易驗證的 循環 開始，不要一開始就把模糊大任務丟進自動化。
測試驅動與自我修正
適合函式、元件、API、小型重構。給 代理 明確測試或 建置 指令，讓它讀失敗結果後修正，直到可執行檢查通過。
目標導向與記憶持久化
適合跨檔案遷移與長任務。使用 `/goal` 類型的完成條件、專案規則、AGENTS.md、CLAUDE.md 或 技能，讓每輪都帶著同一套約束。
動態工作流與對抗驗證
適合大規模 稽核、競品研究、批次報告與多模組重構。將工作分派給多個 子代理，再由合併節點與 審核者 代理 收斂。
核心術語與正確用法
以下名詞用於 AI 代理 工作流討論，避免把不同層級的控制機制混在一起。
驗證閉環
代理 不只「看起來完成」，而是能跑一個明確檢查。Claude Code 文件也強調，沒有可運行檢查時，人就會被迫成為驗證閉環。
評估器與修正器
一個 代理 產生或修改，另一個評估結果是否符合需求。適合報告品質、測試覆蓋、法規或安全規則檢查。
編排器與工作者
編排器拆解任務並收斂成果，工作者各自處理子任務。適合多產品線資料整理、跨 儲存庫 檢查或多來源研究。
持久規則
AGENTS.md、CLAUDE.md、Codex Skill、Hermes 記憶 都是把「下次不要再重講」變成系統規則的方式。
AI 代理 工作流可以先 循環 化的工作
先選重複、可驗證、風險可控的流程；正式知識與客戶內容仍保留人工審核點。
修 程式碼 與驗收
把「改完跑測試、讀錯誤、修正、再測」變成預設迴圈。停止條件是測試、程式檢查、建置、截圖或明確使用者驗收。
raw 到 evidence notes
長篇素材先壓成 證據筆記 與 課程摘要，再進入正式 wiki。原始資料保留在 原始資料，不直接當成正式知識。
教學 HTML 生產線
建立固定流程：素材理解、官方校正、個人教學版型、桌手機檢查、再問是否傳送。避免每次重做同一組判斷。
問題 / 電子郵件 / 報告 摘要
將長信件與報告拆成異常、風險、負責人、期限、下一步。確認欄位完整後再通知，不讓 代理 直接改正式紀錄。
工具控制表：自由度越高，驗證越要硬
Cursor 與 Claude Code 都能長時間工作，但權限模型與風險不同。正式流程要把安全邊界寫清楚。
| 模式 | 適合任務 | 必備控制 | 建議 |
|---|---|---|---|
| Cursor 自動審查／隔離環境 | 中小型修改、重複測試、低風險命令 | 允許清單、隔離測試、刪除保護、敏感檔案保護 | 日常可用，但不要在含敏感資料或大範圍檔案操作時放開權限。 |
| Claude Code `/goal` | 可描述成完成條件的長任務 | 完成條件必須可觀察，例如測試通過、建置成功、指定清單完成 | 適合重構、文件更新、批次修復；條件模糊時先要求 任務摘要。 |
| Claude Code `/loop` | 定時輪詢、CI 狀態追蹤、週期性檢查 | 頻率、最大輪次、停止條件、通知規則 | 用於狀態監控，不用於無界線修改程式碼。 |
| 動態工作流程 | 大規模 稽核、跨來源研究、多 代理 交叉驗證 | 工作分片、合併規則、審核者、成本上限 | 適合 Hermes 多 代理 報告與 Wiki 清理，但要保留人工 關卡。 |
導入路線：先做小而硬的 循環
不要先追求全自動。先讓每個 循環 都有明確輸入、明確輸出、明確失敗訊號。
盤點重複動作
列出每天手動貼錯誤、手動整理報告、手動檢查格式的環節。
定義驗證訊號
每個任務都要有 通過／失敗：測試、建置、結構規格、截圖、欄位完整性。
寫入 技能 / 記憶
把反覆更正的偏好與錯誤變成 Codex Skill、AGENTS.md 或 Hermes 記憶。
擴大到編排
確認單一 循環 穩定後，再做 分散派工、審核者、合併與通知。
一頁總結：把 AI 當系統元件，不是聊天對象
循環工程 的核心不是讓 代理 無限制工作，而是讓它在工程約束下持續改善。
- 任務是否已拆成 代理 能可靠完成的原子步驟？
- 是否有可執行或可觀察的驗證條件？
- 是否限制了高風險工具、刪除動作與敏感檔案？
- 是否設定最大輪次、超時、失敗升級與人工審查點？
- 是否把成功的流程沉澱成 技能、AGENTS.md、CLAUDE.md 或 記憶？
- 是否保留原始證據，並只把整理後的結果進正式知識庫？