📋 Cline Kanban 使用指南
Research Preview — 独立 Web 应用,非 VSCode 内置功能
一句话:Cline Kanban 是一个独立的 Web 看板应用,让你在浏览器里管理大量并行 Agent 任务。不是 VSCode 插件的一部分,而是
npx kanban启动的本地服务。
📦 安装与启动
# 方式一:免安装直接运行
cd /path/to/your/git/repo
npx kanban
# 方式二:全局安装后运行
npm i -g kanban
kanban
# 更新
kanban --update
前置条件:Node.js 18+,需在 git 仓库根目录运行。无需注册或配置,开箱即用。
启动后浏览器自动打开本地 Web UI(默认端口从 8000 开始)。
🎯 核心工作流
Step 1 — 创建任务
- 手动:点击看板上的 + 按钮,写下任务描述
- 通过侧边栏聊天:打开侧边栏让 Agent 帮你把需求拆成多个任务卡片
Step 2 — 链接任务
⌘+点击(Mac)或Ctrl+点击(Win/Linux)一张卡片链接到另一张- 形成依赖链:前置卡片完成后,依赖它的卡片自动启动
Step 3 — 启动任务
- 点击卡片上的 ▶️ 播放按钮
- Kanban 会为每个任务创建 独立的 git worktree(隔离工作目录)
node_modules等 gitignored 文件通过软链接共享,无需重复安装
Step 4 — 监控
- 卡片实时显示 Agent 的最新消息和工具调用
- 可以一眼同时监控几十上百个 Agent
Step 5 — 审查变更
- 点击卡片查看 Agent 的 TUI 界面和 diff
- 支持 checkpoint(将 diff 限定到特定消息范围)
- 点击 diff 行可写评论,评论会作为反馈发回给 Agent
Step 6 — 提交
- Commit:合并到主分支
- Open PR:创建新分支并开启 PR
- Kanban 会自动提示 Agent 处理合并冲突
Step 7 — 归档
- 将卡片拖到 "Done" 列
- worktree 被清理,但保留 resume ID,以后可以恢复
🧩 与 VSCode Cline 的关系
| 概念 | 说明 |
|---|---|
| VSCode Cline 扩展 | 单 Agent 在编辑器内工作,Plan/Act 模式 |
| Kanban 看板 | 多 Agent 并行运行的 Web UI,每个卡片=独立 Agent 会话 |
| Agent Teams | 一个协调 Agent 程序化地委派给其他 Agent,共享任务板和信箱 |
| Sub-agents | 单会话内产生的只读调研子 Agent,轻量级 |
三者是 独立但可配合 的概念:Kanban 为人编排多 Agent 提供界面,Agent Teams 为 Agent 编排 Agent 提供协议。
⚙️ 进阶功能
每任务独立 Agent 选择
不同卡片可以使用不同的 Agent CLI(Cline CLI、Claude Code、Codex、OpenCode、Factory Droid、Kiro 等),看板会自动检测已安装的 CLI 工具。
每任务 Plan/Act 模式
每个卡片可以独立选择 Plan 模式(只读分析)或 Act 模式(可修改文件),切换后状态持久化。
侧边栏聊天 Agent
侧边栏专门负责「管理看板」—— 让它帮你拆分任务、调整卡片、设置依赖,它会专注于看板管理而非写代码。
Diff 评论反馈
审查 diff 时可在代码行上写评论,评论会传回给执行该任务的 Agent 作为反馈,形成「Review → Revise」循环。
🚀 什么时候用 Kanban?
| 场景 | 用什么 |
|---|---|
| 编辑代码,单任务 | VSCode Cline(默认) |
| 多人/多需求并行开发 | Kanban + 卡片拆分解耦 |
| 复杂项目自动分解执行 | Kanban 侧边栏 Agent 拆任务 |
| 让 Agent 自主协调分工 | Agent Teams(SDK/CLI 层) |
| 调研型:快速查多个方向 | Sub-agents(轻量只读) |
💡 当前状态
- Research Preview,功能在快速迭代
- v0.1.67 — "Done" 列名(原 Trash)
- v0.1.60 — 每任务选择不同 Agent
- v0.1.48 — 侧边栏 Agent 专注看板管理
- 核心思路:Human orchestrates parallel agents via Web UI