Kilo CLI Coding Agent

核心用法

本 Skill 为 OpenClaw 提供通过后台进程调用 Kilo CLI 的能力，采用「工作目录隔离 + 后台模式」双核心设计。支持代码构建、PR 审查、批量任务并行三大场景。

基础模式：

• bash workdir:<目录> background:true command:"kilo run <指令>" 启动后台会话
• process action:log/poll/write/kill sessionId:XXX 管理生命周期

典型场景：
1. 代码构建：使用 --full-auto 或 --yolo 标志实现全自动编码
2. PR 审查：严禁在 Clawdbot 自身目录操作，推荐 git worktree 隔离或临时目录克隆
3. 批量并行：通过多后台会话 + 预取 PR refs 实现并发审查
4. 交互式会话：复杂任务使用 tmux 而非纯后台模式

显著优点

• 进程级隔离：每个 Kilo CLI 实例独立运行，互不干扰
• 目录沙盒：workdir 限制文件可见范围，防止敏感文档泄露
• 并行扩展：支持同时启动多个代理处理批量 PR/issue
• 灵活监控：poll/log/write 组合实现非阻塞式进度跟踪

潜在缺点与局限

• 外部依赖：必须全局安装 @kilocode/cli，配置失败则完全不可用
• 无原生安全审计：Kilo CLI 本身为黑盒 AI 编码工具，生成代码需人工复核
• 目录操作风险：误操作可能污染 live 实例（如 ~/Projects/clawdbot）
• 资源占用：并行大量会话可能耗尽系统资源

适合人群

• 需要自动化代码生成/重构的开发者
• 维护多 PR 仓库的代码审查者
• 追求批量 issue 修复效率的工程团队

常规风险

• 代码安全风险：AI 生成代码可能含漏洞或许可证冲突
• 数据泄露风险：未正确设置 workdir 可能导致敏感文件被读取
• 操作破坏性：--full-auto 自动提交变更，需版本控制兜底
• 供应链风险：npm 包更新可能引入 breaking changes

核心用法

本 Skill 提供 Kilo CLI 的后台化编程控制方案，核心模式为 workdir + background：

1. 创建隔离工作区：使用 mktemp -d 或指定项目目录，确保代理只接触相关文件
2. 后台启动代理：bash workdir:~/project background:true command:"kilo run '...'" 返回 sessionId 供追踪
3. 状态监控与干预：通过 process action:log/poll/write/kill 管理会话生命周期

三种典型工作流

| 场景 | 推荐模式 | 关键参数 |

|------|---------|---------|

| 自动构建/生成代码 | `bash background` | `--full-auto` 或 `--yolo` 自动批准变更 |

| PR 代码审查 | `bash background` + git worktree | 绝不使用 `--yolo`，避免修改代码 |

| 多 issue 并行修复 | `tmux` + git worktree | 每个 issue 独立分支，多会话并发 |

显著优点

• 并行扩展性：支持批量启动多个 Kilo CLI 实例，配合 git worktree 实现分支隔离，适合大规模 PR 审查或 issue 修复
• 工作目录隔离：workdir 参数强制沙盒化，防止代理读取无关文件（如 soul.md 等敏感配置）
• 非阻塞执行：background:true 模式让长任务在后台运行，主进程可继续其他操作
• PR 审查安全机制：明确禁止在 Clawdbot 主目录执行分支切换，强制使用临时克隆或 git worktree，避免破坏运行实例

潜在缺点与局限性

• 外部依赖刚性：必须预装 @kilocode/cli，未安装时 Skill 完全失效
• T3 来源风险：维护者为个人开发者（codewithnathan97），非官方团队，长期维护存在不确定性
• 无实际可执行代码：纯 Markdown 文档型 Skill，仅提供使用指南，不包含封装好的自动化逻辑
• 命令示例风险：文档中包含 rm -rf 等危险命令示例，需用户自行判断执行
• 网络依赖：Kilo CLI 运行需连接 LLM API，网络中断导致任务失败

适合人群

• 需要批量处理代码审查 的 Tech Lead 或开源维护者
• 追求自动化工作流 的高级开发者，熟悉 bash/tmux/git worktree 等工具链
• 已部署 Kilo CLI 生态 的团队，希望与 OpenClaw 集成

常规风险

1. 目录误删风险：rm -rf $REVIEW_DIR 示例若变量未正确设置可能误删数据
2. 分支冲突风险：未遵循 "绝不 checkout Clawdbot 主目录" 规则可能导致运行实例损坏
3. API 成本风险：并行启动多个 Kilo CLI 会话可能产生高额 LLM 调用费用
4. 权限扩散风险：--yolo 模式自动批准变更，需确保工作目录范围可控

---

> 认证结论：T-MD 纯文档型 Skill，无可执行代码，依赖官方 Kilo CLI 工具，安全等级 A 级，建议确认外部工具安装后再使用。