支持 Codex、Claude Code、OpenCode、Pi 等多款 AI 编程代理的后台程序化调用，通过工作目录隔离与后台进程实现批量代码任务自动化，适合大规模 PR 审查与并行 Issue 修复。
说明：
## 核心用法
**giga-coding-agent** 是一套多代理编程工具编排框架，允许用户通过后台进程方式调用主流 AI 编程代理（Codex CLI、Claude Code、OpenCode、Pi Coding Agent），实现非交互式、可编程控制的代码任务自动化。
### 关键执行模式
1. **工作目录隔离（workdir）**：强制代理在指定目录启动，避免无关文件干扰，防止代理”迷路”读取敏感配置
2. **后台进程模式（background）**：通过 `bash workdir:XXX background:true command:”…”` 启动，返回 sessionId 用于后续监控
3. **进程生命周期管理**：支持 `process action:log/poll/write/kill` 进行进度监控、输入交互和强制终止
### 多代理支持
| 代理 | 核心命令 | 关键特性 |
|——|———|———|
| **Codex CLI** | `codex exec –full-auto` / `–yolo` | 最强功能，支持沙盒/无沙盒模式，适合构建与审查 |
| **Claude Code** | `claude “task”` | Anthropic 官方，适合复杂推理任务 |
| **OpenCode** | `opencode run “task”` | 轻量替代方案 |
| **Pi Coding Agent** | `pi –provider X –model Y -p “task”` | 多提供商支持（Google/OpenAI），非交互式输出 |
### 典型工作流
**批量 PR 审查**：通过 `git fetch origin ‘+refs/pull/*/head:…’` 预取所有 PR 引用，并行启动多个 Codex 进程分别审查不同 PR，最后汇总结果通过 `gh pr comment` 提交。
**并行 Issue 修复**：结合 `git worktree` 创建隔离分支目录 + `tmux` 会话，实现多代理并行修复不同 Issue，互不影响。
### 安全与限制
– **严格目录隔离**：绝对禁止在 `~/clawd/` 或 `~/Projects/clawdbot/` 启动代理，防止读取敏感配置或破坏运行实例
– **PR 审查安全策略**：Clawdbot 自身 PR 必须通过临时目录克隆或 git worktree 审查，禁止直接 checkout 分支
– **风险等级分层**：`–full-auto`（沙盒内自动批准）vs `–yolo`（无沙盒无审批，最快最危险）
### 适合人群
– 需要批量处理代码审查的维护者/技术负责人
– 追求 CI/CD 自动化集成的开发团队
– 熟悉命令行、能承担多进程管理复杂度的进阶用户
### 潜在局限
1. **学习曲线陡峭**：需掌握 bash background、tmux、git worktree、process API 等多技术栈组合
2. **并发管理负担**：并行代理数量增加时，session 监控和结果聚合复杂度指数上升
3. **供应商锁定风险**：Codex CLI 依赖 OpenAI 生态，Claude Code 依赖 Anthropic，多代理切换需适应不同 CLI 风格
4. **安全误操作风险**：`–yolo` 模式或无隔离目录运行可能导致代码破坏或敏感信息泄露
5. **非交互场景限制**：复杂调试仍需 tmux 交互会话，纯后台模式不适合所有场景
### 常规风险
– **进程孤儿化**：后台任务异常退出时可能遗留僵尸进程
– **API 成本失控**：并行 Codex 调用可能快速消耗 token 额度
– **Git 状态污染**：worktree/workdir 配置错误可能导致分支混乱或代码丢失
– **权限边界模糊**：`–yolo` 模式绕过沙盒，恶意代码可访问全盘文件
会员专属
