核心用法
kilocli-coding-agent 是一个将 Kilo CLI 编码代理托管到后台进程的技能，采用 workdir + background 模式实现非交互式程序化控制。核心工作流程为：在目标目录启动后台代理（bash workdir:XXX background:true command:"kilo run ..."），通过 process 系列命令监控日志、轮询状态、写入输入或终止会话。
主要应用场景：
- 构建/创建项目：使用
--full-auto或--yolo标志自动审批变更，如kilo run "Build a snake game" - PR 审查：支持单 PR 审查（vanilla 模式，无特殊标志）和批量并行审查——通过
git fetch预取 PR refs，为每个 PR 启动独立 Kilo 进程，最后聚合结果用gh pr comment回写 - 并行 Issue 修复：结合 git worktrees 创建隔离分支，通过 tmux 会话托管交互式 Kilo CLI，实现 5+ 个修复任务并行
关键安全措施：
- 严禁在 `~/Projects/openclaw` 运行：该目录为 OpenClaw live 实例，分支切换会导致运行中断
- 审查 OpenClaw PR 时必须克隆到
/tmp或使用 git worktree 隔离 - PR 审查使用 git diff 而非 checkout，避免并行任务冲突
显著优点
- 高并行能力：可同时运行多个 Kilo CLI 进程处理批量 PR/Issue，配合 worktrees 实现真正的隔离
- 安全沙箱设计：通过
workdir限定代理可见范围，防止敏感文件泄露（如 soul.md） - 灵活监控机制：
process:log/poll/write/kill提供完整的生命周期管理 - 标准化输出：内置 "Razor Standard" PR 模板，强制人工化描述、时间戳历史和测试验证，提升维护者友好度
- 与 GitHub 生态深度集成：原生支持
ghCLI 进行 PR checkout、评论创建
潜在缺点与局限性
- 依赖栈复杂：需预装
kilo（npm）、git、gh、tmux四个二进制文件 - 交互式场景受限：复杂交互仍需 fallback 到 tmux 技能，后台模式仅适合非交互式任务
- 资源消耗：并行 army 模式在大型仓库可能产生显著的 CPU/内存占用
- 状态管理挑战：多会话并行时，开发者需手动跟踪 sessionId 与对应 PR/issue 的映射关系
- Kilo CLI 黑箱依赖：代理内部决策逻辑不可控，可能出现"慢任务"需人工 patience
适合人群
- 需要批量处理 GitHub PR 审查的维护者/技术负责人
- 追求自动化编码工作流的高级开发者
- 熟悉 tmux、git worktrees 等 Linux/Unix 工具链的运维工程师
- 团队已采纳 Kilo CLI 作为 AI 编码代理的组织
常规风险
- 环境冲突风险：未正确隔离 workdir 可能导致代理读取敏感配置或污染工作目录
- 认证失效：
gh或kilo的会话过期会导致后台任务静默失败 - 资源泄漏：临时目录（
mktemp -d）和 git worktrees 需显式清理，否则磁盘占用累积 - 并发竞态：同一仓库多个 worktree 若操作重叠文件可能引发冲突
- AI 幻觉传导：Kilo CLI 的代码生成错误可能通过自动化流程批量注入代码库，需人工最终 review
安全评估备注
文档中安全认证报告为系统自动生成的占位符，未执行实际安全扫描，使用者需自行审计 Kilo CLI 及依赖工具的可信度。