Kanban 使用指南

📋 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