coding-agent

• 构建或创建新功能和应用 — 让 coding-agent 探索代码库并进行端到端实现，而非仅进行内联修补。
• 审查拉取请求 — 在临时克隆或 git worktree 中启动一个 coding-agent，使其能够安全地进行差异对比、分析和变更摘要。
• 重构大型代码库 — 涉及多文件的更改需要跨多个文件的上下文，这类任务非常适合由能够遍历项目目录树的 coding-agent 来处理。
• 并行修复问题 — 使用 git worktree 同时运行多个 coding-agent，每个问题对应一个，然后从各自的分支创建 PR。

• 简单的单行修复 — 如果更改显而易见且局限于特定位置，直接编辑文件即可；启动 agent 会增加不必要的开销。
• 只读代码探索 — 使用读取/grep 工具检查代码，而非启动完整的 coding-agent。
• 在 ~/clawd 或实时 OpenClaw 工作区内操作 — 绝不能在编排器自身的工作目录中启动 agent。
• 线程绑定的 ACP 调用请求 — 如果需要在 Discord 线程或类似 ACP 上下文中启动或运行 Codex/Claude Code，请改用带有 runtime:"acp" 参数的 sessions_spawn。

支持四种不同的编码智能体，并为每种智能体提供正确的调用模式。Codex 和 Pi 需要 pty:true 以实现交互式终端行为；Claude Code 使用 --print --permission-mode bypassPermissions 以实现简洁的非 PTY 执行方式。

长时间运行的任务可以通过 background:true 启动，该操作会返回一个 sessionId。随后，你可以使用进程工具操作来轮询状态、流式传输日志、发送标准输入，或终止会话——在不阻塞的情况下持续向用户反馈进度。

设置 workdir 可确保代理在正确的项目文件夹中启动，避免误入无关文件。这对于 PR 审查和并行问题修复至关重要。

为每个问题创建独立的 git worktree，在每个 worktree 中启动专属代理，并发监控它们的进度，并推送独立分支以创建 PR —— 全程无需改动主分支。

在代理的提示末尾附加一个 openclaw system event 命令，这样当任务完成时，编排器可以立即收到唤醒事件，而无需等待下一次心跳轮询。

审查始终在临时克隆或 git worktree 中进行，而非在实时项目文件夹中执行，以防止意外的分支切换或对当前代码库造成修改。

将 Codex 或 Claude Code 的 coding-agent 指向你的项目目录，使用 workdir 并提供清晰的功能需求提示。该 coding-agent 会探索代码库、跨多个文件实现功能并提交代码——同时你可以通过 process action:log 监控整个过程。

获取所有开放的 PR 引用，以后台模式为每个 PR 启动一个 Codex 进程，收集它们的审查结果，并通过 gh CLI 将结果以 GitHub 评论形式发布——所有操作均并行运行。

为每个待处理的 issue 创建一个 git worktree，在每个 worktree 中启动一个 coding-agent，监控进度，然后推送分支并开启 PR 供人工审查——大幅缩短修复时间。

对于没有现有项目的快速一次性提示，可以创建一个临时目录，运行 git init，让 coding-agent 执行一个独立的任务——完成后直接删除该目录即可。