核心用法
kilocli-coding-agent 是一个将 Kilo CLI 作为后台进程运行的技能，用于程序化控制 AI 编码代理。主要模式为 workdir + background：指定工作目录启动隔离的代理会话，通过 process 系列动作（log/poll/write/kill）进行监控与交互。
典型场景
1. 构建/创建项目：使用 --full-auto 或 --yolo 标志自动执行，如 kilo run "Build a snake game"
2. PR 审查：在目标项目目录或临时克隆目录中运行，禁止在 ~/Projects/clawdbot/ 直接操作
3. 批量 PR 审查：通过 git fetch 获取所有 PR refs，并行启动多个 Kilo CLI 实例
4. 并行 issue 修复：结合 git worktree + tmux，在隔离分支中同时处理多个任务
显著优点
- 环境隔离：
workdir参数限制代理可见范围，避免读取无关文件（如 soul.md） - 并行能力：支持同时运行多个实例处理批量任务
- 灵活控制：通过 sessionId 追踪、日志监控、输入注入实现精细化进程管理
- 安全审查机制：明确禁止在 Clawdbot 自身目录操作，强制使用临时目录或 worktree
潜在缺点与局限性
- 外部依赖：必须预先全局安装
@kilocode/cli，配置门槛较高 - 交互复杂性：Kilo CLI 本身需要 TTY，纯后台模式在某些场景下需配合 tmux
- 资源消耗：并行运行多个 LLM 代理对计算资源和 API 配额要求较高
- 状态管理：session 生命周期需手动监控，无自动重试或错误恢复机制
适合人群
- 需要批量处理代码审查、issue 修复的开发者或团队
- 熟悉 bash、git、tmux 的高级用户
- 已将 Kilo CLI 集成到工作流中的组织
常规风险
- 目录污染风险：若在错误目录（如 ~/clawd/）启动，代理可能读取敏感内部文档
- 分支冲突风险：在运行中的 Clawdbot 仓库直接 checkout 分支会破坏实时实例
- 成本失控：并行运行多个 LLM 会话可能导致 API 费用激增
- 输出质量不确定：依赖 Kilo CLI 底层模型的能力，复杂任务可能需要人工复核