核心用法
Kilo CLI Coding Agent技能将Kilo CLI工具包装为后台可编程控制的服务,主要面向两类场景:非交互式自动化任务(bash background模式)和交互式编码会话(tmux模式)。
关键操作流程:
1. 工作目录隔离:通过workdir:参数限定代理可见范围,防止无关文件干扰
2. 后台启动:使用bash background:true启动长期运行任务,返回sessionId用于跟踪
3. 进程管理:支持process action:log/poll/write/kill全生命周期控制
主要功能模块:
- 代码构建:使用
kilo run --full-auto自动批准变更,适合快速原型开发 - PR审查:提供三种安全模式——直接在目标项目审查(非clawdbot项目)、临时克隆审查(clawdbot项目必需)、git worktree隔离审查
- 批量处理:可并行启动多个Kilo CLI实例处理多PR,配合
process action:list统一监控 - 并行修复:结合git worktree+tmux实现多issue并发修复,各工作树完全隔离
安全红线:
- 绝对禁止在
~/Projects/clawdbot/目录操作(会破坏运行实例) - 禁止在
~/clawd/启动Kilo CLI(会读取内部文档导致异常行为) - PR审查前必须先fetch远程refs,使用git diff而非checkout避免分支冲突
显著优点
- 隔离性强:workdir机制实现"小盒子"沙箱,代理仅感知必要文件
- 并行能力突出:支持同时运行5+个Kilo CLI实例,适合规模化代码审查
- 进程可控:完整的sessionId跟踪体系,可随时监控、干预或终止任务
- 模式灵活:background模式适合自动化脚本,tmux模式保留完整TTY交互
- 安全设计明确:内置多项硬性规则防范自我破坏(clawdbot目录保护)
潜在缺点与局限性
- 依赖预装环境:要求全局安装
@kilocode/cli并提前配置 - 无内置状态持久化:sessionId仅内存有效,重启后丢失历史上下文
- 审查输出需人工整合:批量PR审查后需手动执行
gh pr comment提交结果 - tmux复杂度:并行修复流程涉及socket管理、worktree清理等多步骤,出错后残留资源需手动处理
- 非原生集成:本质是shell命令包装,错误处理和重试逻辑需用户自行实现
适合人群
- 维护者:需要批量处理开源项目PR审查的开发者
- 自动化工程师:构建CI/CD流水线中代码质量检查环节
- 多任务处理者:同时推进多个独立issue修复,需严格分支隔离
- Kilo CLI现有用户:已熟悉该工具,希望将其嵌入更大工作流
常规风险
- 资源竞争:并行运行过多Kilo CLI实例可能导致内存/CPU耗尽
- 工作目录污染:mktemp目录若未清理可能泄露敏感代码片段
- 网络依赖:Kilo CLI本身需调用远程模型,后台任务失败时排查困难(建议配合
process action:log持续监控) - 权限边界模糊:
--full-auto模式自动批准文件变更,在共享工作目录中可能产生意外副作用 - git状态冲突:虽强制worktree隔离,但同一账户的多工作树仍共享git config,可能因用户配置导致行为不一致