Claude Code loops 的重點,是把一次性的 prompt 改成有觸發條件、停止條件與驗證標準的工作循環;截至 2026 年 7 月,官方文件已把 /goal/loop、scheduled tasks、routines 與 dynamic workflows 切成不同自動化層級。 對企業和代理商來說,這已超出指令名稱的變化。它把 AI Agent 的管理重心,從寫出更漂亮的提示詞,移到設計「什麼時候開始、什麼時候停、用什麼方式驗證」。

我比較在意的是後半段:token、品質、停損。Agent 一旦可以自己重跑、自己開分支、自己回來修 PR,人類的工作就會變成兩件事。第一,定義邊界。第二,設計便宜、可量化、能重複的驗證方式。這跟 Agentic Coding 時代講的角色轉換一致:工程師越來越像編排者,逐行手敲退到次要位置。

4 種 loop,其實是在分配 4 種責任

Claude Code 官方文件把並行工作拆成 subagents、agent view、agent teams、dynamic workflows;這篇 loop 說明則回答另一個問題:單一任務要怎麼持續推進。兩者接起來看,才會知道該把「下一步」交給誰。

Loop 類型 觸發條件 停止條件 適合任務 成本控制方式
Turn-based 使用者每次 prompt Agent 判定完成或需要更多脈絡 一次性短任務、探索、局部修正 用 skill 固化驗證步驟,減少來回輪數
Goal-based 使用者設定 /goal 條件達成,或達到使用者設定的回合上限 有明確驗收標準的工作 把完成條件寫成測試、分數或檔案狀態
Time-based 時間間隔 使用者取消,或工作完成 PR 巡檢、CI 觀察、每日摘要 拉長間隔,或改用事件觸發
Proactive 排程或事件 單次任務達標;routine 持續到關閉 issue triage、依賴升級、回饋處理 小模型處理例行工作,大模型只做判斷

這張表真正有用的地方在於權責清楚,分類只是外殼。Turn-based loop 把檢查留給人;goal-based loop 把停止條件交給模型評估器;time-based loop 把觸發交給時間;proactive loop 把整個提示與觸發方式包成 routine 或 workflow。當一個團隊開始用 agent 處理真實專案,這 4 格會直接影響成本、事故率與交付節奏。

Turn-based loop:先把「人工驗收」寫成 skill

最容易上手的是 turn-based loop。你發一個 prompt,Claude 讀程式、修改、測試,然後回報結果。問題是:如果每一輪都靠人提醒「請開頁面看一下」「請查 console」「請跑效能 trace」,那個人其實還在當排程器。

比較好的做法,是把驗收方法寫進 SKILL.md。原始範例保留如下:

---
name: verify-frontend-change
description: 在声明完成之前,对任何 UI 变更进行端到端验证。
---

# 验证前端变更

不要仅仅因为代码编辑成功,就报告 UI 变更已经完成。要像真人 reviewer 那样验证它:
1. 启动开发服务器,并在浏览器中打开被修改的页面。
2. 直接与变更交互。对于新的控件(按钮、输入框、开关):点击它,确认预期的状态变化,并截图记录前后对比。
3. 检查浏览器控制台:不能出现新的错误或警告。
4. 使用 Chrome DevTools MCP,运行一次性能 trace,并审计 Core Web Vitals。

如果任何一步失败,修复问题,并从第 1 步重新开始。不要交回只验证了一部分的工作。

Claude Code skills 的商業價值在這裡很明顯:它把「資深工程師腦中的 checklist」變成可重複載入的操作規範。官方文件也指出,skills 只在相關時載入,長篇參考材料平常幾乎不吃 context。對一個月處理數十個網站修改的團隊來說,這比每次重寫 prompt 更接近流程資產。

Goal-based loop:用 /goal 把 done 寫清楚

Goal-based loop 適合有明確出口的任務,例如測試通過、Lighthouse 分數達標、清空 backlog、或把一組 API call site 全部遷移完成。/goal 文件顯示,這個功能需要 Claude Code v2.1.139 以上;每一輪結束後,較小且較快的模型會檢查條件是否成立。條件沒達成,Claude 進下一輪;條件成立,goal 自動清除。

原始範例:

/goal get the homepage Lighthouse score to 90 or above, stop after 5 tries.

同一段也保留了中文版本:

/goal 将首页 Lighthouse 分数提升到 90 或以上,最多尝试 5 次后停止。

這句話有兩個值得保留的設計。第一,成功條件明確寫成 90 分以上,避免停在「改善效能」這種模糊要求。第二,最多 5 次,避免 agent 在模糊目標裡燒 token。官方成本文件寫得很直接:Claude Code 依 API token 消耗計費,企業部署平均約 USD 13(約 NTD 416)每位開發者活躍日,月均約 USD 150-250(約 NTD 4,800-8,000)每位開發者。當 loop 會自動跑多輪,停止條件就是成本控制。

Time-based loop:用 /loop 看外部世界,但別讓它變成噪音

Scheduled tasks 文件/loop 定義為 session-scoped 的重複 prompt。它可以每 5 分鐘查一次部署、觀察 PR、處理 review comment,也可以讓 Claude 自己選 1 分鐘到 1 小時之間的延遲。固定 interval 的最小粒度是 1 分鐘;同一 session 最多 50 個 scheduled tasks;recurring task 會在建立後 7 天到期。

原始範例:

/loop 5m check my PR, address review comments, and fix failing CI

同一段也保留了中文版本與本機限制提醒:

/loop 每 5 分钟检查我的 PR,处理 review 评论,并修复失败的 CI。

/loop 在你的电脑上运行,所以如果你关机,它也会停止。你可以通过 /schedule 创建 routine,把这个 loop 移到云端。

這類 loop 很好用,也最容易失控。PR 還在 CI 排隊時,每 5 分鐘查一次合理;一個低頻依賴更新檢查若也每 5 分鐘跑,成本和噪音都會被放大。官方文件建議,若工作需要離開當前 session、在筆電關機後仍持續,就改用 routines、Desktop scheduled tasks 或 GitHub Actions。

Proactive loop:routine、workflow 與 code review 才是組織層級的形狀

Proactive loop 的差異在於人不一定在線上。保留下來的操作範例把 /schedule/goal、dynamic workflows 和 auto mode 組起來,用於回饋處理:

/schedule every hour: check the project-feedback channel for bug reports. /goal: don't stop until every report found this run is triaged, actioned, and responded to. When fixing a bug, use a workflow to explore three solutions in parallel worktrees and have a judge adversarially review them.

同一段也保留了中文版本:

/schedule 每小时:检查 project-feedback 频道中的 bug 报告。 /goal:不要停止,直到本次运行发现的每个报告都已被分类、处理并回复。
修复 bug 时,使用 workflow 在并行 worktrees 中探索三种方案,并让一个 judge 以对抗性方式审查它们。

這個 prompt 可怕之處不在長度,而在它開始像一個小型營運系統:定時查資料、定義完成條件、平行探索三個修法,再要求另一個 judge 做反向審查。Dynamic workflows 官方文件也把用途講得很窄:它適合 codebase-wide audit、500-file migration、cross-checked research 這類一個 conversation 不好承載的工作。v2.1.154 以上才支援 dynamic workflows,Pro 方案還需要在 /config 打開。

這也是 Agent Harness 這類觀念會變重要的原因。模型能力只是底層。真正決定產出的,是外面那層觸發、記憶、工具、權限、review、rollback 和成本儀表板。

原始比較表:選錯 loop,成本會先爆

教學素材最後用一張表收斂判斷。原始表格保留如下,因為它把每種 loop 交出去的責任寫得夠清楚:

| Loop | 你交出去的部分 | 什么时候用 | 该选什么 |
| --- | --- | --- | --- |
| Turn-based | 检查步骤 | 你还在探索或做决策时 | 自定义验证 skills |
| Goal-based | 停止条件 | 你知道什么叫完成时 | `/goal` |
| Time-based | 触发器 | 工作按日程发生在项目外部时 | `/loop`、`/schedule` |
| Proactive | prompt 本身 | 工作是周期性的,而且定义清楚时 | 上面所有能力,加上 dynamic workflows |

臺灣讀者可以把它換成這個判斷表:

Loop 交出去的責任 適用時機 優先工具
Turn-based 檢查步驟 仍在探索或做決策 自訂驗證 skills
Goal-based 停止條件 已經知道完成狀態 /goal
Time-based 觸發器 工作按時程發生在專案外部 /loop/schedule
Proactive prompt 本身 工作週期固定且定義清楚 前述能力,加上 dynamic workflows

我會把它翻成一個更務實的選擇題:你現在最想移交的是「檢查、停止、觸發,還是整個提示」?如果只是想少打一點字,先寫 skill。若完成條件可以量化,才用 /goal。工作來自外部時間或事件,再考慮 /loop/schedule。至於 proactive loop,最好先從低風險任務開始,例如 issue 分類、文件 drift、PR smoke check;別一開始就讓它改核心結帳流程。

對企業導入的 5 個操作建議

決策點 建議做法 可衡量指標
驗證 把重複驗收流程寫成 skill 每次任務少 1-3 輪人工提醒
停止條件 /goal 必須含分數、測試或明確檔案狀態 每個 goal 都有 pass/fail 證據
觸發頻率 /loop 先用 15-60 分鐘,除非真的需要 5 分鐘級別 每日 scheduled task 次數
模型分工 例行分類用小模型,架構判斷用高階模型 每類任務 token 占比
審查 重要變更交給第二 agent 或 /code-review 高風險 PR 覆蓋率

這裡的商業結構會很快浮現。Agent loop 降低人力切換成本,但會增加 token、審查和治理成本。能賺回來的團隊,通常會避免把 agent 開到最大,改把例行工作壓到便宜模型與 deterministic checks,把高價模型留給判斷、例外和設計。

FAQ

Claude Code loops 跟一般 prompt engineering 差在哪裡?

Prompt engineering 主要優化單次輸入;Claude Code loops 管理的是重複執行。它多了觸發條件、停止條件、驗證與成本邊界。這讓 AI Agent 可以處理跨多輪、跨時間或跨事件的任務。

什麼任務最適合先用 /goal

先選有明確驗收方式的任務,例如測試通過、Lighthouse 達 90 分、lint 為零錯誤、某個 queue 清空。不要用「把產品做得更好」這種條件。官方文件明確提醒,評估器不會自己讀檔或跑工具,它只能根據對話中 Claude 提供的證據判斷。

/loop/schedule 要怎麼選?

/loop 適合目前 session 裡的輪詢,例如等待 CI、處理 PR review。/schedule 對應 cloud routine,適合筆電關機後仍要跑的週期工作。Scheduled tasks 文件也列出差異:/loop 跑在你的機器、需要 open session;cloud routine 跑在 Anthropic cloud、最小間隔 1 小時。

Proactive loop 會不會讓品質下降?

會,如果沒有驗證層。Loop 本身只保證工作會持續,不保證輸出正確。比較穩的做法,是把每次變更接上測試、截圖、console 檢查、second-agent review 或 managed Code Review,再把失敗案例寫回 skill。

Tenten 會怎麼用這套方法在客戶專案裡?

我們會先把高重複、低風險流程做成 skill 和 /goal,例如廣告素材 QA、網站改版驗收、SEO 技術檢查和文件同步。等驗證指標穩定後,再把部分流程升級成 scheduled task 或 routine,避免一開始就把不可逆工作交給自動化。

權威引用

Author Insight

我們在導入 AI 開發流程時,最常看到的失敗來自流程錯置:團隊把「跑很多次」誤認成「有流程」。真正有用的 loop 會留下驗證證據、成本紀錄和可回收的操作規範。Tenten 在網站改版、SEO 技術檢查與 AI agent 工作流導入中,已經把這類檢查拆成可重複的驗收步驟。

術語表

術語 定義
Claude Code loops 讓 Claude Code 依觸發與停止條件重複工作的模式
Turn-based loop 使用者每次 prompt 觸發的一輪 agentic work
Goal-based loop /goal 定義完成條件,由評估器決定是否繼續
Time-based loop /loop 或 scheduled task 依時間間隔重跑 prompt
Proactive loop 由排程、事件或 routine 觸發,無需人類即時在線
Skill SKILL.md 固化操作規範、檢查流程或工具知識的能力包
Dynamic workflow 用 JavaScript 腳本編排多個 subagents 的 Claude Code 工作流
Share this post
Ewan Mak

I'm a Full Stack Developer with expertise in building modern web applications that fast, secure, and scalable. Crafting seamless user experiences with a passion for headless CMS, Vercel and Cloudflare

Loading...