代理循环（Agent Loops）

Agent Loops 是预建的多代理工作流，它将顺序和并行步骤链接在一起，代理之间传递实际输出。

描述 Agent Loops 编排多步骤代理管道。每个工作流定义了一系列步骤；每个步骤通过 claude -p 以特定角色系统提示和代理-swarm 模型路由运行。输出在步骤之间传递，因此每个代理都建立在前一个代理的工作基础上。

使用场景 当用户想要：

• 构建、创建或发布任何内容 —— 应用程序、Web 应用程序、网站、移动应用程序（iPhone/Android）、桌面应用程序、API、CLI、机器人、仪表盘、登陆页面、SaaS 产品、MVP、原型、插件、扩展、微服务
• 修复、调试、排除故障或诊断错误、崩溃或失败的测试
• 审查、审计或检查代码中的错误、安全漏洞或质量问题
• 研究、调查、比较或撰写关于任何主题的报告
• 重构、重组、清理、优化或现代化代码
• 测试、审查并将技能发布到 ClawHub

安装 clawhub install agent-loops 或者克隆到您的技能目录： git clone https://github.com/OpenClaw/agent-loops.git workspace/skills/agent-loops

要求 PyYAML 用于 YAML 工作流： pip install pyyaml

使用 工作流选择 —— 匹配用户的意图到工作流： 用户说类似的话... 工作流 "构建一个应用程序"、"创建一个 Web 应用程序"、"制作一个网站"、"发布这个功能"、"开发一个移动应用程序"、"启动一个 SaaS"、"制作一个 iPhone 应用程序"、"构建一个 Android 应用程序"、"创建一个桌面应用程序"、"制作一个 CLI 工具"、"构建一个 API"、"创建一个机器人"、"制作一个仪表盘"、"构建一个登陆页面"、"创建一个 MVP"、"原型 X"、"添加黑暗模式"、"实现 Y"、"构建一个插件"、"制作一个扩展"、"创建一个服务"、"启动一个微服务"、"搭建一个项目" ship_feature "修复这个错误"、"调试 X"、"为什么 Y 出错"、"排除故障这个错误"、"诊断崩溃"、"这不起作用"、"X 有问题"、"在 X 时出现错误"、"它在 X 上崩溃"、"构建失败"、"测试失败"、"修复这个问题"、"热修复 X" bug_fix "审查这段代码"、"审计代码库"、"检查安全问题"、"检查这个 PR"、"在 X 中查找错误"、"分析这个模块"、"这段代码是否安全"、"检查漏洞"、"查看我的更改"、"进行安全审查"、"扫描问题"、"评估代码质量" code_review "研究 X"、"比较 A 和 B"、"撰写关于 Y 的报告"、"调查 Y"、"探索 X 的选项"、"X 的最佳实践是什么"、"研究 X 的领域"、"深入研究 X"、"总结 X 的状态"、"X 的优缺点"、"分析 X 的市场"、"撰写关于 X 的发现报告" research_report "重构 X"、"清理这段代码"、"重组 Y"、"重组代码库"、"优化这个模块"、"现代化架构"、"减少技术债务"、"简化这个"、"提取服务"、"解耦 X 和 Y"、"改进代码结构"、"使其更易维护" refactor "发布这个技能"、"推送到 ClawHub"、"发布这个技能"、"部署到 ClawHub"、"发布这个技能"、"准备这个技能发布" skill_publish

命令模式： python3 workspace/skills/agent-loops/scripts/run_workflow.py <工作流> "<用户请求>" --apply 将用户的自然语言请求作为输入。工作流自动处理范围、委托和输出链接。

示例 示例 1：发布一个功能 场景：您想要范围、实现和记录一个新功能。 操作：python3 workspace/skills/agent-loops/scripts/run_workflow.py ship_feature "在设置中添加黑暗模式切换" --apply 结果：PM 范围任务，Dev 实现并测试，编辑器编写文档和更改日志。

示例 2：修复一个错误 场景：一个错误需要诊断、修复和回归测试。 操作：python3 workspace/skills/agent-loops/scripts/run_workflow.py bug_fix "登录页面在空密码时崩溃" --apply 结果：Dev 诊断根因，Dev 实现修复，Tester 编写回归测试，编辑器记录更改。

示例 3：并行代码审查 场景：您想要同时运行代码审查和安全审计。 操作：python3 workspace/skills/agent-loops/scripts/run_workflow.py code_review "审查认证模块" --apply 结果：审查者和安全审计员并行运行，然后编辑器合成一个统一的摘要。

示例 4：覆盖模型 场景：您想要所有步骤使用特定的模型。 操作：python3 workspace/skills/agent-loops/scripts/run_workflow.py research_report "比较 REST 和 GraphQL" --apply --model sonnet 结果：所有步骤使用指定的模型而不是代理-swarm 路由。

命令 python3 workspace/skills/agent-loops/scripts/run_workflow.py <工作流> "<输入>" # 干跑工作流 python3 workspace/skills/agent-loops/scripts/run_workflow.py <工作流> "<输入>" --apply # 运行代理 python3 workspace/skills/agent-loops/scripts/run_workflow.py --list # 列出可用工作流 python3 workspace/skills/agent-loops/scripts/run_workflow.py --list --json