
AgentLoop
AgentLoop 是一个本地优先的代理工作流,它通过每个周期运行新的 Codex 工作程序、强制执行独立的评论员评估标准以及使用您的项目文件作为具有完全可观察性和控制的持久内存,将有界目标转换为已发布的代码。
https://agentloop.tools/?ref=producthunt&utm_source=aipure

产品信息
更新于:2026年07月24日
什么是 AgentLoop
AgentLoop 是一个开发者优先的系统,用于通过 AI 自动化迭代编码的“中继工作”——一次规划,然后反复在实现、审查和修复之间切换,直到满足您的标准。它作为 OpenAI Build Week 项目构建并作为本地工具发布(MIT 许可),在您的代码所在的位置运行,专为实际软件任务而设计,例如功能、迁移、重构和强化。AgentLoop 不依赖于冗长、漂移的聊天上下文,而是保持目标和验收标准稳定(例如,在 goal.md 和 GUIDELINES.md 中),并生成可审计的循环日志,以便您可以看到发生了什么,并在需要时停止或引导。
AgentLoop 的主要功能
AgentLoop 是一个本地优先、面向开发者的代理工作流工具,它通过运行重复的“工作者→评论者”循环,直到满足用户定义的标准,从而消除了规划和执行之间的“人工中继”。您定义一个有界目标和“完成定义”(例如,在 GUIDELINES.md 中),然后 AgentLoop 在每个周期派遣新的基于 Codex 的工作者,直接在您的真实存储库中实施更改,运行检查/测试,并使用独立的评论者审查结果并将具体的修复反馈到下一次迭代中。它强调可观察性(实时仪表板、记录、裁决、回放)、可靠性(每个周期的新鲜上下文 + 文件作为内存)和控制(周期预算、取消、基于规则的停止条件),其架构通过 MCP 将规划与本地执行分开,并旨在保持引擎可插拔性。
每个周期都有新的工作者: 每次迭代都在一个干净、新鲜的上下文中运行,以减少复合的提示漂移,同时仍然通过项目文件作为持久的真相来源进行进展。
带有基于规则裁决的独立评论者: 独立的评论者根据您的标准(存储在 GUIDELINES.md 等文件中)审查工作者的输出,并返回具体的修复;循环继续直到评论者输出 PASS/发布级别的裁决。
在您的真实存储库中进行本地优先执行: 在您的代码所在的位置运行(需要 Node.js 18+、Git、经过身份验证的 Codex CLI),因此更改、测试和证据直接在实际项目环境中生成——无需托管工作区。
可观察、可回放的代理周期: 提供仪表板和日志,以检查每个周期的记录、工具结果、成本和文件交接,以及回放工具,以了解发生了什么以及为什么。
有界目标、预算和停止条件: 您设置明确的目标和验收标准,通过周期预算限制迭代,并可以取消运行——保持自主性受限且对生产友好。
MCP 边界和引擎可插拔方向: 使用 MCP 将规划与本地执行分开,并保持清晰的边界,以便随着时间的推移交换/添加引擎(目前以 Codex 为主,暗示更广泛的支持作为路线图)。
AgentLoop 的使用场景
软件团队中的自主功能交付: 通过给 AgentLoop 一个有界目标来交付端到端功能(UI + API + 测试 + 文档);工作者实施,评论者强制执行质量,循环迭代直到规则显示通过。
带有回归强化的错误修复: 分类和修复“绿色测试”不足以解决的缺陷:评论者可以发现细微问题,要求回归覆盖,并推动迭代改进直到验证。
安全和质量强化通过: 运行一个集中的强化目标(例如,输入处理、边缘情况、健壮性),通过评论者驱动的审查,确保更改符合明确的标准,并为发现的弱点添加测试。
代码库迁移和重构: 执行通常需要人工看管的多步骤重构或迁移(编辑文件、运行测试、根据失败进行调整),通过让循环处理重复的周期和证据收集。
独立开发者和初创公司的开发效率: 用可重复的工作者/评论者循环和清晰的可观察性,取代大量的自定义编排以及规划工具和编码代理之间的手动往返。
优点
规则驱动的可靠性:独立的评论者和明确的 GUIDELINES.md 风格标准有助于防止“完成”仅仅基于通过测试。
本地优先和透明:在真实存储库中运行,具有强大的可观察性(仪表板、记录、回放),使其更容易信任和审计更改。
新鲜上下文周期减少漂移:每个周期重新启动工作者可以提高一致性并减少长时间运行中复合的错误。
缺点
设置和依赖约束:需要 Node.js 18+、Git 和经过身份验证的 Codex CLI;实用性取决于拥有该工作环境。
迭代成本和时间:基于循环的自主性可能比单次通过工作流消耗更多的周期(以及因此更多的令牌/计算),尤其是在复杂任务上。
不适用于确定性工作流:固定、可预测的序列可能更适合简单的管道,而无需代理循环的开销。
如何使用 AgentLoop
1) 定义一个有界目标和验收标准: 准确写下您希望 AgentLoop 完成什么(功能、迁移、强化、完善),并使其有界。还要将您的“完成定义”定义为评估标准(通过的必要条件)。AgentLoop 网站建议一次规划(例如,在 ChatGPT 中),然后向 AgentLoop 提供明确的目标和标准。
2) 将您的评估标准放入 GUIDELINES.md 中: 在您的项目(或 AgentLoop 工作目录中,具体取决于您如何运行它)中创建或更新名为 GUIDELINES.md 的文件。此文件被视为持久标准:每个周期都会读取它,并由评论员用于决定通过/失败(例如,“所有测试必须通过”、“为每个缺陷添加回归覆盖”、“文档与结果匹配”)。
3) 准备您的本地环境: 确保您拥有 Node.js 18+、Git 和已认证的 Codex CLI(AgentLoop 的本地优先说明明确要求这些)。
4) 克隆 AgentLoop: 运行:git clone --branch v1.1.0 --depth 1 https://github.com/aiedwardyi/AgentLoop.git
5) 进入 AgentLoop 目录: 运行:cd AgentLoop
6) 在您的代码所在的位置启动本地守护程序: 运行守护程序进程(如官方说明所示):node src\daemon.js。这会在本地启动 AgentLoop,以便它可以在实际项目环境中操作文件。
7) 向 AgentLoop 提供工作请求(目标): 向 AgentLoop 提供具体的任务目标(网站示例:“在 UI、API 和回归套件中添加 CSV 导出。”)。保持其有界并与 GUIDELINES.md 中的评估标准对齐,以便评论员可以评估完成情况。
8) 设置循环/迭代预算(推荐): 配置一个小的循环预算,以便循环不会无限期运行(网站显示了一个示例“循环预算:3”)。这反映了常见的代理循环最佳实践:限制迭代/轮次或预算以控制成本和运行时间。
9) 让 AgentLoop 运行其工作程序→评论员循环: AgentLoop 将重复执行以下操作:(a) 将目标发送给一个新的工作程序进程,(b) 让工作程序编辑本地文件并运行项目命令/测试,(c) 让独立的评论员根据 GUIDELINES.md 审查结果,以及 (d) 如果失败,将评论员的反馈反馈到下一个循环中。
10) 使用文件作为循环之间的持久内存: AgentLoop 的设计强调“每个周期都有新的上下文”,同时“文件推动工作向前发展”。确保工作程序将证据写入存储库(代码更改、测试、文档、日志),以便下一个周期可以在其基础上构建,而无需依赖冗长的聊天历史记录。
11) 监控进度和可观察性输出: 通过网站上描述的仪表板/重放功能跟踪逐周期判断(通过/失败)、记录和成本/收据。这是您在无人值守运行时保持可见性的方式。
12) 如有需要,停止或取消: 如果运行偏离轨道或您想提前停止,请从仪表板取消(网站明确提到从仪表板取消)。
13) 通过评论员的最终裁决确认完成: 当评论员的最后一行报告“VERDICT: PASS”时,根据 GUIDELINES.md,运行被视为完成。AgentLoop 的流程明确是评估标准驱动的:您的标准决定了完成。
14) 审查最终更改并发布: 一旦通过,审查您的本地项目中的最终代码/测试/文档更改,并继续您的正常发布工作流程(提交、PR、发布),使用循环日志和评论员收据作为支持证据。
AgentLoop 常见问题
AgentLoop 是一个本地优先的代理循环工具(OpenAI 2026 年构建周项目),它允许您一次性设置一个有界目标和验收标准,然后它会使用全新的 Codex 工作人员和一个独立的评论员重复运行循环,以改进您的本地项目,直到它符合您的评估标准。











