最近，關(guān)于如何為編碼智能體“設(shè)計(jì)循環(huán)（loop）”而不是僅僅編寫(xiě)提示詞，有很多討論。如果你花一些時(shí)間在 X 上試圖弄清楚循環(huán)到底是什么，會(huì)看到多種不同的答案。

在 Claude Code 團(tuán)隊(duì)，我們將循環(huán)定義為：智能體反復(fù)執(zhí)行工作周期，直到滿足停止條件。我們根據(jù)以下幾個(gè)方面，將循環(huán)分成不同類型：

• 如何觸發(fā)；
• 如何停止；
• 使用哪一種 Claude Code 原語(yǔ)；
• 每種循環(huán)最適合哪類任務(wù)。

下面會(huì)介紹主要的循環(huán)類型、各自適用的場(chǎng)景，以及如何在管理 token 用量的同時(shí)維持代碼質(zhì)量。并非所有任務(wù)都需要復(fù)雜循環(huán)；請(qǐng)從最簡(jiǎn)單的解決方案開(kāi)始，有選擇地使用這些模式。

基于輪次的循環(huán)（Turn-based loops）

• 觸發(fā)方式： 用戶提示詞。
• 停止條件： Claude 判斷任務(wù)已經(jīng)完成，或需要更多上下文。
• 最適合： 不屬于固定流程或日程安排的短期任務(wù)。
• 用量管理： 編寫(xiě)具體明確的提示詞，并使用技能（skills）改進(jìn)驗(yàn)證過(guò)程，從而減少交互輪數(shù)。

你發(fā)送的每個(gè)提示詞，都會(huì)啟動(dòng)一個(gè)由你逐輪引導(dǎo)的手動(dòng)循環(huán)。Claude 收集上下文、采取行動(dòng)、檢查自己的工作，在必要時(shí)重復(fù)這些步驟，最后給出回復(fù)。我們稱之為智能體循環(huán)（agentic loop） 。

例如，你讓 Claude 創(chuàng)建一個(gè)點(diǎn)贊按鈕。它會(huì)讀取代碼、完成修改、運(yùn)行測(cè)試，然后交付一個(gè)它認(rèn)為可以正常工作的結(jié)果。接著，你手動(dòng)檢查結(jié)果，再編寫(xiě)下一條提示詞。

你可以把自己的人工檢查步驟寫(xiě)進(jìn) SKILL.md，以改進(jìn)驗(yàn)證環(huán)節(jié)，讓 Claude 能夠端到端地檢查更多自己的工作。技能中應(yīng)包含相應(yīng)的工具或連接器，使 Claude 能夠查看、測(cè)量結(jié)果，或直接與結(jié)果交互。檢查越量化，Claude 就越容易完成自我驗(yàn)證。

例如，你可以在 SKILL.md 文件中寫(xiě)入：

---
name: verify-frontend-change
description: 在宣布完成之前，對(duì)任何 UI 更改進(jìn)行端到端驗(yàn)證。
---
# 驗(yàn)證前端更改
絕不能只因?yàn)榫庉嫵晒蛨?bào)告 UI 更改已經(jīng)完成。要像人工審查者一樣驗(yàn)證它：
1. 啟動(dòng)開(kāi)發(fā)服務(wù)器，并在瀏覽器中打開(kāi)修改后的頁(yè)面。
2. 直接與改動(dòng)交互。對(duì)于新增控件（按鈕、輸入框、開(kāi)關(guān)）：點(diǎn)擊它，確認(rèn)發(fā)生預(yù)期的狀態(tài)變化，并分別截取操作前后的畫(huà)面。
3. 檢查瀏覽器控制臺(tái)：不得出現(xiàn)新的錯(cuò)誤或警告。
4. 使用 Chrome DevTools MCP 運(yùn)行性能追蹤，并審計(jì) Core Web Vitals。
如果任何一步失敗，請(qǐng)修復(fù)問(wèn)題并從第 1 步重新執(zhí)行；不要交付只完成了部分驗(yàn)證的工作。

基于目標(biāo)的循環(huán)（Goal-based loop，/goal）

• 觸發(fā)方式： 實(shí)時(shí)輸入的手動(dòng)提示詞。
• 停止條件： 目標(biāo)達(dá)成，或達(dá)到最大輪數(shù)。
• 最適合： 具備可驗(yàn)證退出條件的任務(wù)。
• 用量管理： 設(shè)置具體的完成標(biāo)準(zhǔn)和明確的輪數(shù)上限，例如“嘗試 5 次后停止”。

有時(shí)，一個(gè)輪次不足以完成任務(wù)，復(fù)雜任務(wù)尤其如此。智能體在能夠迭代時(shí)表現(xiàn)更好。你可以使用 /goal 明確定義“完成”的樣子，從而延長(zhǎng) Claude 持續(xù)迭代的時(shí)間。

當(dāng)你定義成功標(biāo)準(zhǔn)后，Claude 就不必自行判斷什么是“足夠好”，也不會(huì)過(guò)早結(jié)束循環(huán)。每當(dāng) Claude 嘗試停止時(shí)，評(píng)估模型都會(huì)檢查你的條件；如果條件尚未滿足，就會(huì)讓它返回繼續(xù)工作，直到目標(biāo)達(dá)成或達(dá)到你設(shè)定的輪數(shù)。

這就是為什么確定性的標(biāo)準(zhǔn)格外有效，例如通過(guò)測(cè)試的數(shù)量，或達(dá)到某個(gè)評(píng)分閾值。

例如：

/goal 將首頁(yè)的 Lighthouse 得分提升到 90 分或以上，嘗試 5 次后停止。

基于時(shí)間的循環(huán)（Time-based loop，/loop和/schedule）

• 觸發(fā)方式： 指定的時(shí)間間隔。
• 停止條件： 由你取消，或者工作本身完成（例如 PR 已合并、隊(duì)列已清空）。
• 最適合： 重復(fù)性工作，或需要與外部環(huán)境、外部系統(tǒng)交互的任務(wù)。
• 用量管理： 設(shè)置更長(zhǎng)的時(shí)間間隔，或者改為根據(jù)事件而不是時(shí)間作出響應(yīng)。

有些智能體工作會(huì)反復(fù)發(fā)生：任務(wù)保持不變，只有輸入會(huì)變化。例如，每天早上匯總 Slack 消息。另一些工作依賴外部系統(tǒng)；與這類系統(tǒng)交互的一種簡(jiǎn)單方式，是定期檢查，并根據(jù)發(fā)生的變化采取行動(dòng)。例如，某個(gè) PR 可能收到代碼審查意見(jiàn)，或者 CI 可能失敗。

針對(duì)這類任務(wù)，可以使用 /loop 觸發(fā) Claude 按照固定時(shí)間間隔重新運(yùn)行提示詞。例如：

/loop 5m 檢查我的 PR，處理代碼審查意見(jiàn)，并修復(fù)失敗的 CI。

/loop 在你的電腦上運(yùn)行，因此關(guān)機(jī)后它也會(huì)停止。你可以使用 /schedule 創(chuàng)建例程，把循環(huán)遷移到云端。

主動(dòng)式循環(huán)（Proactive loops）

• 觸發(fā)方式： 由事件或日程觸發(fā)，無(wú)需人工實(shí)時(shí)參與。
• 停止條件： 每項(xiàng)任務(wù)在目標(biāo)達(dá)成時(shí)退出；例程本身會(huì)持續(xù)運(yùn)行，直到你將其關(guān)閉。
• 最適合： 持續(xù)出現(xiàn)、定義清晰的重復(fù)性工作，例如錯(cuò)誤報(bào)告、Issue 分類、遷移、依賴升級(jí)等。
• 用量管理： 將例程分配給更小、更快的模型；只有需要判斷時(shí)，才使用能力最強(qiáng)的模型。

上面介紹的原語(yǔ)，還可以與 Claude Code 的其他功能組合，構(gòu)成長(zhǎng)時(shí)間運(yùn)行的循環(huán)，例如自動(dòng)模式（auto mode）和動(dòng)態(tài)工作流（dynamic workflows，研究預(yù)覽版）。

例如，要處理不斷到來(lái)的反饋，可以使用：

• /schedule（研究預(yù)覽版）運(yùn)行一個(gè)檢查新報(bào)告的例程；
• /goal 定義什么算完成，并用技能記錄如何驗(yàn)證；
• 動(dòng)態(tài)工作流編排多個(gè)智能體，對(duì)每份報(bào)告進(jìn)行分類、修復(fù)并審查修復(fù)結(jié)果；
• 自動(dòng)模式讓例程持續(xù)運(yùn)行，而不會(huì)停下來(lái)請(qǐng)求權(quán)限。

把這些組合起來(lái)后，提示詞可以寫(xiě)成：

/schedule 每小時(shí)執(zhí)行：檢查 project-feedback 頻道中的錯(cuò)誤報(bào)告。
/goal：在本輪發(fā)現(xiàn)的每份報(bào)告都完成分類、處理并獲得回復(fù)之前，不要停止。
修復(fù)錯(cuò)誤時(shí)，使用工作流在三個(gè)并行 worktree 中探索三種解決方案，
再讓一個(gè)評(píng)審智能體以對(duì)抗式方式審查它們。

保持代碼質(zhì)量

循環(huán)輸出的質(zhì)量，取決于它周圍的整個(gè)系統(tǒng)。設(shè)計(jì)這個(gè)系統(tǒng)時(shí)，請(qǐng)注意：

• 保持代碼庫(kù)本身整潔： Claude 會(huì)沿用代碼庫(kù)中已經(jīng)存在的模式和約定。
• 讓 Claude 能夠驗(yàn)證自己的工作： 通過(guò)技能寫(xiě)清楚你和團(tuán)隊(duì)眼中的“好結(jié)果”是什么。
• 讓文檔易于獲?。?/strong> 框架和庫(kù)的文檔中包含最新的最佳實(shí)踐。
• 使用第二個(gè)智能體做代碼審查： 擁有全新上下文的審查者偏見(jiàn)更少，也不會(huì)被主智能體的推理過(guò)程影響。你可以使用內(nèi)置的 /code-review 技能，或 GitHub 的 Code Review。