SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场coding-agent

coding-agent

编程与开发

查看项目

更新于 10-16 05:39

技能介绍

用途

Coding Agent（后台优先）用于以程序化方式、非交互地运行编码智能体。它支持 Codex CLI、Claude Code、OpenCode 或 Pi Coding Agent，通过 bash 后台进程启动，从而可以批量、并行地执行编码任务。该技能建议：非交互式编码工作使用 bash 后台模式；交互式编码会话则使用 tmux 技能（除非常简单的一次性提示外，始终如此）。

主要能力

  • 以 workdir + background 模式启动智能体，返回 sessionId 用于追踪。
  • 通过 process 动作监控与控制：log 查看日志、poll 检查是否完成、write 发送输入（如智能体提问时回复 "y"）、kill 终止。
  • 支持 Codex CLI：构建/创建时使用 --full-auto（沙箱但自动批准工作区变更）或 --yolo（无沙箱、无批准）；PR 审查使用无特殊标志的 vanilla 方式。
  • 支持并行批量 PR 审查：先 fetch 所有 PR refs，再为每个 PR 部署一个 Codex 进程，通过 process action:list 统一监控，并用 gh pr comment 发布结果。
  • 支持 Claude Code（claude）、OpenCode（opencode run）与 Pi Coding Agent（pi）的调用；Pi 提供常用标志：--print/-p（非交互，运行提示后退出）、--provider（选择提供方，默认 google）、--model（选择模型，默认 gemini-2.5-flash）、--api-key（覆盖 API key，默认取环境变量）。
  • 通过 git worktrees + tmux 并行修复多个 issue：为每个 issue 创建隔离分支的 worktree，在独立 tmux 会话中启动 Codex，捕获窗格输出监控进度，完成后推送分支并创建 PR，最后清理。

使用方式

基本模式：创建临时工作目录（SCRATCH=$(mktemp -d)），然后在目标目录中以 bash workdir:<目录> background:true command:"<agent command>" 启动智能体并获取 sessionId；随后用 process action:log/poll/write/kill 进行监控与操作。workdir 的作用是让智能体在聚焦目录中唤醒，不会漫游读取无关文件。

Codex CLI 示例：构建用 codex exec --full-auto "..." 或 codex --yolo "..."；审查 PR 用 codex review --base main。审查 PR 时，切勿在 Clawdbot 自身项目文件夹中进行，可改用提交 PR 的实际项目（若非 ~/Projects/clawdbot）、克隆到临时文件夹，或使用 git worktree。批量审查时先 git fetch origin '+refs/pull//head:refs/remotes/origin/pr/'，再为每个 PR 启动一个 codex exec 进程。

其他智能体：Claude Code 使用 claude "Your task"；OpenCode 使用 opencode run "Your task"；Pi 需先安装 npm install -g @mariozechner/pi-coding-agent，再使用 pi "Your task"，例如 pi --provider openai --model gpt-4o-mini -p "Summarize src/"。

并行修复 issue：克隆仓库到临时位置，为每个 issue 创建 worktree（git worktree add -b fix/issue-78 /tmp/issue-78 main），使用 tmux 创建会话并 send-keys 启动 Codex（如 codex --yolo 'Fix issue #78: <description>. Commit and push.'），用 capture-pane 监控，完成后 git push 并用 gh pr create 创建 PR，最后 kill-server 并移除 worktree。

适用场景

  • 非交互式、可批量或并行的编码任务。
  • 批量 PR 审查与并行 issue 修复。
  • 需要程序化控制编码智能体进程（监控、输入、终止）的工作流。

限制与规则

  • 交互式编码会话应使用 tmux（除极简单一次性提示外）。
  • 尊重用户对工具的选择：用户要求 Codex 就用 Codex，绝不主动提出自行构建。
  • 要有耐心，不要因为会话“慢”就终止。
  • 使用 process:log 监控，避免干扰。
  • 构建时用 --full-auto，审查时用 vanilla。
  • 绝不在 ~/clawd/ 中启动 Codex；绝不在 ~/Projects/clawdbot/ 中 checkout 分支（那是运行中的实时实例），应克隆到 /tmp 或使用 git worktree。
  • 向外部仓库提交 PR 时应使用文档给出的模板格式，包含原始提示、功能说明、功能意图、带时间戳的提示历史、测试方式、会话日志、实现细节等部分。

备注：资料中的 --yolo 是 --dangerously-bypass-approvals-and-sandbox 的快捷方式；Codex CLI 默认模型为 gpt-5.2-codex（在 ~/.codex/config.toml 中设置）。