核心用法
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模式绕过沙盒，恶意代码可访问全盘文件