核心理念通过Cline Kanban统一编排 3 个 AI Agent设计师 / 实现者 / 审查者每个角色作为一个任务卡片在独立 Git Worktree 中并行执行卡片间通过依赖链自动串联人类只需在浏览器看板上审查 Diff 和决策。一、架构总览1.1 统一编排模型Cline Kanban 任务面板 Agent 运行时 Worktree 管理器Cline Kanban不是贴在看板上的装饰层它是整个多 Agent 工作流的编排核心。它与传统手动方式的本质区别对比维度旧方式手动 3 终端新方式Cline Kanban启动 Agent手动开 3 个终端分别 cd 到不同 worktree在浏览器看板上点击卡片 ▶ 按钮Worktree 管理手动git worktree add/removeKanban 自动创建/清理临时 worktree任务依赖人工检查前置任务是否完成Ctrl点击链接卡片自动串联进度监控AltTab 切换 3 个终端窗口一个浏览器页面所有卡片状态一目了然代码审查手动 git diff手动写审查意见卡片内 Diff 查看器 行内评论合并交付手动 git merge / cherry-pick点击 Commit 或 Open PR 按钮┌──────────────────────────────────────────────────────────────────────┐ │ 浏览器 — Cline Kanban 看板 │ │ │ │ ┌──────────┐ CtrlClick ┌──────────┐ CtrlClick ┌──────────┐ │ │ │ 设计 │ ──────────→ │ 实现 │ ──────────→ │ 审查 │ │ │ │ 认证模块 │ 依赖链 │ 认证模块 │ 依赖链 │ 认证模块 │ │ │ │ │ │ │ │ │ │ │ │ Agent A │ │ Agent B │ │ Agent C │ │ │ │ 设计师 │ │ 实现者 │ │ 审查者 │ │ │ │ │ │ │ │ │ │ │ │ [▶ Play] │ │ ⏳ 等待中 │ │ ⏳ 等待中 │ │ │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ │ │ │ ├─────────┼──────────────────────────┼──────────────────────────┼───────┤ │ ▼ ▼ ▼ │ │ Git WorktreeKanban 自动管理每个卡片一个临时 worktree │ │ │ │ 卡片 设计认证模块 卡片 实现认证模块 卡片 审查认证模块 │ │ → 临时 worktree #1 → 临时 worktree #2 → 临时 worktree #3 │ │ → 独立 Git 分支 → 独立 Git 分支 → 独立 Git 分支 │ │ → 独立 node_modules → 独立 node_modules → 独立 node_modules│ │ │ │ Agent A 在此编码 Agent B 在此编码 Agent C 在此编码 │ │ Claude Code 自动运行 前置完成自动启动 前置完成自动启动│ │ │ ├──────────────────────────────────────────────────────────────────────┤ │ │ │ .agents/ 协议文件可选补充用于复杂的跨 Agent 设计文档共享 │ │ ├── design/ ← 设计产出物 │ │ ├── implementation/ ← 实现说明 │ │ └── review/ ← 审查报告 │ │ │ │ 注常规协作通过 Kanban 卡片 Diff 审查 行内评论完成 │ │ .agents/ 仅用于需要持久化保存的设计文档场景 │ └──────────────────────────────────────────────────────────────────────┘1.2 三角色定义映射为 3 个 Kanban 任务卡片角色Kanban 卡片自动 Worktree职责核心输出Agent A — 设计师卡片 “设计认证模块”Kanban 自动创建临时 worktree需求分析、架构设计、接口定义、技术选型设计文档Agent B — 实现者卡片 “实现认证模块”卡片 A 完成后自动创建编码实现、单元测试、Bug 修复代码 测试Agent C — 审查者卡片 “审查认证模块”卡片 B 完成后自动创建代码审查、安全审计、质量评估审查报告 行内评论关键理解你不需要为每个 Agent 手动分配 worktree 目录或分支。Cline Kanban 在你点击卡片 ▶ 按钮时自动创建临时 worktree完成后移到 Trash 自动清理。你只需要关心卡片描述里写什么提示词。1.3 技术选型理由组件角色为什么选它Cline Kanban统一编排层一站式管理任务创建→Agent 启动→Worktree 管理→Diff 审查→交付。零配置npx kanban启动兼容 Claude Code 作为 Agent 运行时Git Worktree内置隔离机制Cline Kanban 自动为每个卡片创建临时 worktreeAgent 互不干扰完成后自动清理.agents/ 文件协议可选补充通信当需要持久化设计文档或复杂跨角色引用时使用日常协作通过 Kanban 的 Diff 查看器 行内评论完成二、环境准备2.1 前置条件只需要三样东西# PowerShell / Git Bash 均可node--version# 需要 18Cline Kanban 依赖git--version# 任意版本claude--version# Claude Code 已安装# 进入你的 Git 项目Cline Kanban 必须在 git 仓库根目录启动cd/e/VSCodeProject/multi-agent-project⚠️注意Cline Kanban 必须在已有至少一个 commit 的 Git 仓库中启动。如果项目还是空的先git init git commit --allow-empty -m init。2.2 一键启动 Cline Kanban# 在项目根目录执行零配置自动安装依赖npx kanban浏览器自动打开http://127.0.0.1:port你将看到 Cline Kanban 看板界面。第一次启动时会弹出 Agent 选择对话框。选择Claude Code作为 Agent 运行时。之后可在 Settings 中随时更改。2.3 Cline Kanban 自动管理一切你不需要手动做的事你不需要…因为 Cline Kanban 自动…手动git worktree add点击卡片 ▶ 时自动创建临时 worktree手动git branch每个卡片自动分配独立分支手动开 3 个终端窗口Agent 在 worktree 内自动运行手动git merge/cherry-pick点击 Commit 或 Open PR 按钮手动git worktree remove卡片移到 Trash 自动清理创建 System Prompt 文件角色提示词直接写在卡片描述里2.4 可选创建 CLAUDE.md 注入项目上下文在项目根目录创建CLAUDE.md所有 Agent 启动时会自动读取# CLAUDE.md — Multi-Agent Project Context ## Project Overview 本项目使用 Cline Kanban 的 3-Agent 互审工作流。 - 卡片 1设计需求分析、架构设计、接口定义 - 卡片 2实现按设计编码、单元测试 - 卡片 3审查代码审查、安全审计、质量评估 ## Coding Standards - 遵循项目已有的代码风格 - 所有新函数需有文档注释 - 所有新功能需包含单元测试 - Commit message 遵循 conventional commits 格式 ## Tech Stack 根据你的项目填写三、Cline Kanban 实操创建 3 个 Agent 任务卡片这一章是你实际操作的步骤。不需要打开任何终端窗口——一切在浏览器看板中完成。3.1 启动看板如果还没开cd/e/VSCodeProject/multi-agent-project npx kanban3.2 首次启动选择 Agent 运行时第一次启动 Cline Kanban 时会弹出对话框让你选择使用哪个 CLI Agent在对话框中选择Claude Codeclaude确认选择后Cline Kanban 会记住这个配置存储在~/.cline/kanban/config.json后续启动不会再弹窗// ~/.cline/kanban/config.json{selectedAgentId:claude,agentAutonomousModeEnabled:false// 建议保持 false关键操作仍需你审批}3.3 创建第一个任务卡片设计师在看板的Backlog列中点击“ Add Task”或按快捷键c输入以下内容卡片标题设计用户认证模块卡片描述Prompt你是一名资深系统架构师设计师角色。请完成以下任务 需求实现一个用户认证模块支持 JWT Token 签发与校验。 请完成 1. 分析需求设计模块架构 2. 定义 API 接口端点、请求/响应格式 3. 定义数据模型数据库表结构、字段类型 4. 说明技术选型理由 5. 设计线程安全方案和错误处理策略 输出 - 设计文档保存为 docs/auth-design.md - 接口定义保存为 docs/auth-api.md点击Create创建卡片。3.4 创建第二个任务卡片实现者同样在 Backlog 列中点击“ Add Task”卡片标题实现用户认证模块卡片描述Prompt你是一名资深后端工程师实现者角色。请根据设计文档完成编码实现 1. 先阅读 docs/auth-design.md 和 docs/auth-api.md 了解设计 2. 按照设计规范实现代码到 src/ 目录 3. 编写完整的单元测试到 tests/ 目录 4. 如果发现设计中存在不可行、模糊或遗漏的地方 - 在代码中以 TODO/FIXME 注释标注 - 记录到 docs/impl-notes.md 要求 - 所有公开函数必须有文档注释 - 测试覆盖率不低于 80% - 遵循项目已有的代码风格点击Create创建卡片。3.5 创建第三个任务卡片审查者卡片标题审查用户认证模块卡片描述Prompt你是一名资深代码审查专家审查者角色。请执行以下审查任务 1. 阅读 docs/auth-design.md 了解设计意图 2. 审查 src/ 中的代码实现对照设计文档检查一致性 3. 检查 tests/ 的测试覆盖率 4. 检查安全漏洞OWASP Top 10 5. 检查性能问题算法复杂度、资源使用 审查报告格式 ## 概述 ## 严重问题必须修复才能合并 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTED 输出到 docs/review-report.md点击Create创建卡片。3.6 链接卡片形成依赖链这是 Cline Kanban 最强大的功能——Ctrl 点击链接卡片按住Ctrl 键点击卡片 “设计用户认证模块”然后点击卡片 “实现用户认证模块”一条依赖线建立设计 → 实现设计完成后实现自动启动重复操作Ctrl 点击“实现用户认证模块” → 再点击 “审查用户认证模块”第二条依赖线实现 → 审查实现完成后审查自动启动现在看板上应该是这样的依赖链 设计认证模块 ──→ 实现认证模块 ──→ 审查认证模块 (Backlog) (Backlog) (Backlog)3.7 启动工作流点击第一个卡片 “设计用户认证模块” 上的▶ Play 按钮。Cline Kanban 会自动为这个卡片创建一个临时 Git Worktree在 Worktree 中启动 Claude Code AgentAgent 读取卡片描述中的 Prompt 并开始工作卡片状态从 Backlog → In Progress你可以在卡片上看到 Agent 的最新消息/工具调用后续自动发生设计卡片完成 → 移到 Review 列 → 实现卡片自动启动▶实现卡片完成 → 移到 Review 列 → 审查卡片自动启动▶四、工作流程核心4.1 卡片生命周期Backlog待办 → In Progress进行中 → Review审查 → Trash已完成/清理 │ │ │ │ │ 点击 ▶ Play │ Agent 工作中 │ 你审查 Diff │ 点击 Commit │ 自动创建 Worktree │ 卡片显示最新输出 │ 行内评论反馈 │ 或 Open PR │ 启动 Claude Code │ │ │ 然后移到 Trash4.2 Phase 1: 设计师工作自动执行点击 ▶ 后卡片 “设计用户认证模块” 进入 In ProgressCline Kanban 自动创建临时 worktreeClaude Code 以设计师角色启动读取卡片描述中的 PromptAgent 分析需求、设计架构、编写 API 定义、数据模型你在看板上看到 Agent 的实时输出最新消息/工具调用Agent 完成后的操作卡片自动进入 Review 列你点击卡片 → 查看Diff所有文件变更如果设计不满意 → 在 Diff 行上点击添加行内评论→ 评论发送回 Agent 修改如果设计满意 → 依赖链触发卡片 “实现用户认证模块”自动启动▶4.3 Phase 2: 实现者工作自动启动设计卡片完成后实现卡片自动启动无需人工干预Cline Kanban 创建新的临时 worktreeClaude Code 以实现者角色启动Agent 先读取设计师产生的文件docs/auth-design.md然后开始编码src/目录 tests/目录如果发现设计问题Agent 会在代码中标注 TODO/FIXME4.4 Phase 3: 审查者工作自动启动实现完成后审查卡片自动启动Cline Kanban 创建新的临时 worktreeClaude Code 以审查者角色启动Agent 对照设计文档审查代码输出结构化审查报告4.5 Phase 4: 人类审查与交付三个卡片全部完成后你来最终审查逐个点击卡片→ 查看每个 Agent 的 Diff 和输出在 Diff 上留行内评论如果有问题→ Agent 会收到反馈并修改对于满意的卡片点击Commit→ Agent 自动将 Worktree 的变更合并到主分支或点击Open PR→ Agent 创建 Pull Request移到 Trash→ Worktree 被清理磁盘空间释放如果需要恢复 → 每个卡片有 resume ID可以恢复继续工作五、审查与互审机制在 Cline Kanban 中审查不是另开一个终端手动写报告——而是直接在看板 UI 中完成。5.1 三层审查体系┌─────────────────────────────────────────────────────────────┐ │ 第一层人类实时审查 │ │ │ │ 每个卡片完成后进入 Review 列 → 你点击卡片 → 查看 Diff │ │ → 在具体代码行上点击 → 留下行内评论 → Agent 收到反馈并修改 │ │ │ │ 这是最直接的审查方式所见即所得不经过中间文档 │ ├─────────────────────────────────────────────────────────────┤ │ 第二层Agent C 自动审查 │ │ │ │ 审查卡片的 Agent 自动对照设计文档审查代码 │ │ → 输出结构化审查报告docs/review-report.md │ │ → 标注严重/主要/次要问题 │ │ → 给出 APPROVED / NEEDS CHANGES / REJECTED 裁决 │ ├─────────────────────────────────────────────────────────────┤ │ 第三层可选交叉审查卡片 │ │ │ │ 如果需要设计师审查实现、实现者审查设计 │ │ → 在 Backlog 中创建额外审查卡片 │ │ → 写清楚请审查前面卡片的输出对照原始设计 │ │ → 不需要手动开终端不需要 protocol.md │ └─────────────────────────────────────────────────────────────┘5.2 实操如何审查一个卡片的输出卡片状态进入 Review 列后→ 点击卡片打开详情查看 Agent 的 TUI终端界面回放→ 了解 Agent 的思考过程查看 Diff所有文件变更→ 支持按 checkpoint消息范围分段查看在 Diff 行上点击→ 弹出评论框 → 输入反馈 → Agent 会收到并处理满意后→ 点击 Commit 合并到主分支或 Open PR 走 Pull Request 流程5.3 可选创建交叉审查卡片如果标准 3 卡片流程不够可以增加交叉审查卡片 “交叉审查实现是否符合设计”让设计师审查实现你是设计师。请审查前面 Agent 的实现是否忠于你的设计 1. 阅读 docs/auth-design.md你的设计 2. 查看仓库中 src/ 的实际代码 3. 找出任何设计偏差、遗漏的实现项 4. 对每个偏差标注文件路径和行号 5. 给出结论设计一致 / 存在偏差需修正 / 设计本身需要调整 输出到 docs/cross-review-designer.md卡片 “交叉审查设计的可实施性”让实现者审查设计你是实现者。请基于你的实现经验审查设计的可行性 1. 重新审视 docs/auth-design.md 2. 标注设计中模糊、遗漏、或过度设计的部分 3. 说明哪些设计决策在实现中遇到了困难 4. 给出结论设计可行 / 需要调整 / 需要重新设计 输出到 docs/cross-review-implementer.md创建后同样用 CtrlClick 链接到依赖链末端审查卡片完成后自动触发交叉审查。5.4 裁决与交付最终由你人类做裁决情况操作所有卡片审查通过点击 Commit → Agent 合并到主分支 → 卡片移到 Trash有小问题需要修改在 Diff 上留行内评论 → Agent 修改 → 重新审查有大问题创建新卡片修复 → 链接到问题卡片后面设计需要大改在 “设计” 卡片 Diff 上评论 → 要求 Agent 重新设计 → 下游卡片自动感知变更六、Git Worktree 原理Cline Kanban 自动管理⚠️本节是理解性内容。你不需要手动操作任何 worktree 命令——Cline Kanban 已经自动处理一切。以下内容帮助你理解背后的机制。6.1 Cline Kanban 如何使用 Worktree当你点击 Kanban 卡片上的 ▶ 按钮时Cline Kanban 自动执行以下操作为这个卡片创建一个临时ephemeralGit WorktreeWorktree 位于项目目录外的临时位置拥有独立的分支AgentClaude Code在这个 worktree 中运行修改互不干扰当你把卡片移到 Trash 时worktree 自动被清理你的项目目录 Cline Kanban 自动管理 E:\VSCodeProject\ 你看不到也不需要关心 multi-agent-project/ ├── .git/ ← 共享 临时 worktree #1 → 卡片 设计认证模块 ├── src/ 临时 worktree #2 → 卡片 实现认证模块 └── docs/ 临时 worktree #3 → 卡片 审查认证模块 ↑ Cline Kanban 在卡片启动时自动创建 卡片移到 Trash 时自动删除6.2 关键优化node_modules 符号链接Cline Kanban 会自动将主仓库中的node_modules等 gitignored 文件符号链接到每个 worktree 中。这意味着不需要为每个 Agent 重新npm installAgent 看不到其他 Agent 的 node_modules 修改但如果 Agent 需要修改 gitignored 文件如安装新包变化会影响主仓库的副本6.3 你需要知道的 Git 命令仅用于排查# 查看当前所有 worktree包括 Kanban 自动创建的gitworktree list# 如果 Kanban 崩溃或异常退出可能有残留 worktree# 手动清理谨慎确保没有 Agent 正在运行gitworktree prune七、Cline Kanban 完整操作参考7.1 什么是 Cline KanbanCline Kanban 是 Cline 生态中的多 Agent 编排看板。它是一个本地浏览器应用通过npx kanban一键启动零配置。核心能力说明任务看板Backlog → In Progress → Review → Trash 四列式管理一键启动 Agent点击卡片 ▶ 按钮自动创建 worktree 并启动 Claude Code依赖链CtrlClick 链接卡片前置完成自动触发后续Diff 审查点击卡片查看完整 Diff支持 checkpoint 分段浏览行内评论在 Diff 任意行点击评论反馈直达 Agent一键交付Commit 合并到主分支或 Open PR 走审查流程Sidebar Chat内置聊天 Agent可帮你拆分任务并自动建卡片多 CLI Agent 兼容支持 Claude Code、Cline CLI、Codex、OpenCode 等7.2 安装与启动# 全局安装可选安装后可直接用 kanban 命令npmi-gkanban# 或直接 npx 启动推荐无需安装cd/e/VSCodeProject/multi-agent-project npx kanban# 浏览器自动打开 → http://127.0.0.1:port7.3 首次配置选择 Agent 运行时第一次启动 Cline Kanban 会弹出 Agent 选择对话框选择Claude Codeclaude确认后配置保存到~/.cline/kanban/config.json{selectedAgentId:claude,agentAutonomousModeEnabled:false}agentAutonomousModeEnabled: false→ 关键操作需要你审批推荐agentAutonomousModeEnabled: true→ Agent 完全自主执行适合信任度高的任务后续可在界面右上角Settings按钮中更改。7.4 看板列说明列含义操作Backlog待办任务点击 “” 新建卡片或从 Sidebar Chat 让 Agent 自动拆分In Progress正在执行Agent 在此列中运行卡片显示最新消息/工具调用Review等待人类审查Agent 完成任务后进入此列点击卡片查看 DiffTrash已完成/已清理移到此处自动清理 worktree释放磁盘。每个卡片保留 resume ID 可恢复7.5 快捷键快捷键操作c创建新卡片Ctrl Click卡片 A → 卡片 B链接卡片A 完成后 B 自动启动Delete删除选中卡片7.6 卡片 Prompt 编写技巧Cline Kanban 中每个卡片的描述Prompt就是该 Agent 的 System Prompt。写好 Prompt 是整个工作流质量的关键✅ 好的 Prompt 你是一名资深后端工程师。请按照 docs/auth-design.md 的设计实现用户认证模块。 要求1) JWT 签发和校验 2) 密码 bcrypt 加密 3) 单元测试覆盖率 80% ❌ 差的 Prompt 实现用户认证Prompt 模板设计师你是一名资深系统架构师。请完成 [功能名称] 的设计 需求[具体需求描述] 请完成 1. 模块架构设计含架构图描述 2. API 接口定义端点、请求/响应格式、错误码 3. 数据模型设计表结构、字段类型、索引 4. 技术选型及理由 5. 安全与性能考量 输出文件docs/[feature]-design.md, docs/[feature]-api.mdPrompt 模板实现者你是一名资深工程师。请按照设计文档实现 [功能名称] 1. 先阅读 docs/[feature]-design.md 了解设计 2. 严格按照设计规范编码 3. 编写完整的单元测试 4. 如果发现设计问题在代码中以 TODO/FIXME 标注并记录到 docs/impl-notes.md 要求所有公开函数有文档注释测试覆盖率 80%Prompt 模板审查者你是一名资深代码审查专家。请审查 [功能名称] 的实现 1. 阅读 docs/[feature]-design.md 了解设计意图 2. 对照设计审查代码实现 3. 检查安全漏洞OWASP Top 10 4. 检查性能和代码质量 审查报告格式输出到 docs/review-[feature].md ## 概述 ## 严重问题必须修复 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTED7.7 Cline Kanban 配置文件说明// ~/.cline/kanban/config.json{selectedAgentId:claude,// Agent 运行时claude / cline / codex / opencodeagentAutonomousModeEnabled:false// false关键操作需审批, true全自主}7.8 Cline Kanban 数据存储数据位置看板配置~/.cline/kanban/config.json卡片数据~/.cline/kanban/workspaces/hash/boards.json临时 Worktree系统临时目录Kanban 自动管理7.9 Sidebar Chat用 Agent 自动拆任务Cline Kanban 内置一个 Sidebar Chat Agent你可以对它说“我有一个项目需要实现用户认证功能帮我拆分成设计、实现、审查三个任务卡片并链接起来”Sidebar Agent 会自动创建卡片、填写合适的 Prompt、并建立依赖链。这是最快的启动方式。八、进阶优化8.1 使用 Sidebar Chat 自动拆任务最快启动方式不看板手动创建卡片直接打开 Kanban 的 Sidebar Chat对内置 Agent 说“我有一个项目需要实现用户认证功能包含 JWT 签发校验、密码加密、Token 刷新。帮我拆分成设计、实现、审查三个任务链接起来并给每个卡片填好合适的 Prompt。”Sidebar Agent 会自动完成创建 3 个卡片填写角色化的 Prompt建立 CtrlClick 依赖链你只需点击第一个卡片的 ▶ 按钮8.2 使用 CLAUDE.md 注入项目上下文在项目根目录创建CLAUDE.mdKanban 启动的每个 Agent 都会自动读取# CLAUDE.md — Multi-Agent Project Context ## Project Overview 本项目使用 Cline Kanban 的 3-Agent 互审工作流。 卡片通过 CtrlClick 建立依赖链设计 → 实现 → 审查 ## Communication - 前置卡片的输出在 docs/ 目录中后续卡片需先读取 - 发现问题时在代码中以 TODO/FIXME 标注并记录到 docs/impl-notes.md ## Directory Structure - docs/ — 设计文档、API 定义、审查报告 - src/ — 源代码 - tests/ — 测试文件 ## Coding Standards - 遵循项目已有代码风格 - 所有公开函数必须有文档注释 - 所有新功能必须包含单元测试 - Commit message 遵循 conventional commits 格式8.3 全局安装 Cline Kanban更快启动# 全局安装后直接用 kanban 命令启动无需每次 npx 下载npmi-gkanban# 之后在任何 git 项目中直接kanban8.4 Cline Kanban CI/CD 集成Cline Kanban 支持通过 CLI 在 CI/CD 中运行 Agent# .github/workflows/agent-review.ymlname:Agent Code Reviewon:[pull_request]jobs:review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-name:Run Agent Reviewrun:|npx kanban --headless --task 审查本 PR 的代码变更对照设计文档输出审查报告 \ --agent claude九、实际操作 Demo完整示例以下是以实现一个任务队列模块为例的完整 Cline Kanban 操作流程。Step 1: 启动 Cline Kanbancd/e/VSCodeProject/multi-agent-project npx kanban# 浏览器自动打开看板Step 2: 创建三个卡片按c键或点击 “”依次创建卡片 1: “设计任务队列模块”Prompt:你是一名资深系统架构师。请设计一个任务队列模块 需求 - 支持优先级队列 - 支持任务超时取消 - 线程安全 - 提供 C API 请完成 1. 模块架构设计含模块间关系描述 2. API 接口定义函数签名、参数、返回值、错误码 3. 数据结构设计队列节点、任务描述符等 4. 线程安全方案锁策略、无锁方案评估 5. 性能考量时间复杂度分析 输出文件docs/task-queue-design.md, docs/task-queue-api.md卡片 2: “实现任务队列模块”Prompt:你是一名资深 C 工程师。请实现任务队列模块 1. 先阅读 docs/task-queue-design.md 和 docs/task-queue-api.md 2. 按设计实现代码到 src/task_queue.c 和 src/task_queue.h 3. 编写完整单元测试到 tests/test_task_queue.c 4. 如果发现设计问题在代码中以 TODO/FIXME 标注记录到 docs/impl-notes.md 要求所有公开函数有文档注释测试覆盖率 80%卡片 3: “审查任务队列模块”Prompt:你是一名资深代码审查专家。请审查任务队列模块 1. 阅读 docs/task-queue-design.md 了解设计意图 2. 审查 src/task_queue.c 和 src/task_queue.h 3. 审查 tests/test_task_queue.c 的覆盖率 4. 检查线程安全问题死锁、竞态条件、数据竞争 5. 检查内存管理泄漏、越界、double-free 审查报告格式输出到 docs/review-task-queue.md ## 概述 ## 严重问题必须修复才能合并 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTEDStep 3: 建立依赖链按住Ctrl先点击卡片 1再点击卡片 2 → 链接建立按住Ctrl先点击卡片 2再点击卡片 3 → 链接建立Step 4: 启动点击卡片 1 的▶ Play按钮。Cline Kanban 自动完成卡片 1 → In Progress → Agent 设计师工作卡片 1 完成 → Review 列 → 卡片 2自动启动卡片 2 完成 → Review 列 → 卡片 3自动启动你无需做任何操作等着看结果Step 5: 审查与交付所有卡片进入 Review 列后逐个点击查看 Diff对不满意的代码行添加评论 → Agent 收到反馈修改全部满意后 → 点击Commit或Open PR所有卡片移到Trash→ Worktree 自动清理十、注意事项与最佳实践10.1 Cline Kanban 注意事项问题说明Kanban 依赖 Git 仓库项目必须有至少一个 commit空仓库需先git commit --allow-empty -m init卡片 Prompt 即 System Prompt卡片描述的质量直接决定 Agent 输出质量参考 7.6 节的模板agentAutonomousModeEnabled建议保持false关键操作如 git push、删除文件需要你审批卡片移到 Trash 不可逆虽然有 resume ID但恢复不一定完整。确认交付后再 Trash多个 Agent 不能同时修改同一文件如果两个卡片的 Prompt 都需要修改 src/main.c先完成第一个再启动第二个10.2 Prompt 编写最佳实践明确角色第一句就说明 “你是一名资深 XX 工程师”具体输入明确告诉 Agent 去哪里读前置文档如docs/auth-design.md具体输出指定输出文件路径和格式限制范围不要让一个卡片做太多事一个卡片一个职责包含验收标准如 “测试覆盖率 80%”、“所有公开函数有文档注释”10.3 Windows 环境特别注意事项注意事项说明Node.js 版本Cline Kanban 需要 Node.js 18Git 路径确保git在 PATH 中可用首次 npx 较慢首次npx kanban需要下载依赖后续会快很多或npm i -g kanban一劳永逸claude 命令确保claude在 PATH 中如果不在Cline Kanban 的 Settings 中可指定完整路径编码问题所有.md文件统一用 UTF-8 编码避免中文乱码防火墙npx kanban启动本地服务器如弹窗询问网络访问点击允许10.4 适用于不同规模项目的配置项目规模推荐配置小型单模块1k 行npx kanban 3 个卡片 手动 CtrlClick 链接中型多模块1k-10k 行npx kanban Sidebar Chat 拆任务 CLAUDE.md 交叉审查卡片大型多模块10k 行npx kanban Sidebar Chat CLAUDE.md CI/CD 集成 自定义 Prompt 模板库十一、快速启动 Checklist□ 1. 确保 Node.js 18 (node --version) □ 2. 确保 Git 仓库已初始化并至少有 1 个 commit □ 3. 确保 Claude Code 已安装 (claude --version) □ 4. cd 到项目根目录 □ 5. 启动 Cline Kanban (npx kanban) — 浏览器自动打开 □ 6. 首次启动选择 Agent 类型为 Claude Code □ 7. (可选) 用 Sidebar Chat 说帮我拆分 XXX 功能为设计、实现、审查三个卡片 □ 8. (或手动) 按 c 键创建 3 个卡片填写角色 Prompt □ 9. CtrlClick 链接卡片设计 → 实现 → 审查 □ 10. 点击第一个卡片的 ▶ Play 按钮 □ 11. 所有卡片完成 → Review 列 → 逐个点击查看 Diff □ 12. 在 Diff 上留行内评论如果有问题 □ 13. 点击 Commit 或 Open PR □ 14. 所有卡片移到 Trash十二、扩展思路12.1 扩展到更多 Agent在 Cline Kanban 中扩展非常简单——多创建几个卡片并链接卡片: 安全审计 → 卡片: 性能优化 → 卡片: 文档生成 (Agent D) (Agent E) (Agent F)新角色卡片 Prompt 要点安全审计专家专注 OWASP Top 10 漏洞扫描、依赖安全审计、密钥泄露检测性能优化专家专注 profiling、内存优化、算法复杂度优化、缓存策略文档工程师专注 API 文档、用户指南、CHANGELOG、README 更新12.2 自定义 Prompt 模板库在项目docs/prompts/目录维护常用 Prompt 模板docs/prompts/ ├── designer-template.md ← 设计师 Prompt 模板 ├── implementer-template.md ← 实现者 Prompt 模板 ├── reviewer-template.md ← 审查者 Prompt 模板 ├── security-auditor.md ← 安全审计 Prompt 模板 └── perf-optimizer.md ← 性能优化 Prompt 模板创建卡片时直接复制模板内容替换[功能名称]等占位符。12.3 与 CI/CD 集成# .github/workflows/multi-agent-review.ymlname:Multi-Agent Reviewon:[pull_request]jobs:review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-uses:actions/setup-nodev4with:node-version:18-name:Run Agent Review via Kanbanrun:|npx kanban --headless --task 审查本 PR输出审查报告到 docs/pr-review.md --agent claude-name:Check Verdictrun:|grep -q REJECTED docs/pr-review.md echo Review rejected exit 1 || echo Review passed十三、附录 A: 手动 3-Session 模式备选方案如果你无法使用 Cline Kanban或需要更精细的手动控制以下是最简化的手动方案# 在一个 PowerShell 窗口分 3 个标签页# 标签页 1 (设计师):cd E:\VSCodeProject\multi-agent-project claude你是系统架构师请设计 XXX 功能。输出设计文档到 docs/# 标签页 2 (实现者):cd E:\VSCodeProject\multi-agent-project claude你是工程师请阅读 docs/ 中的设计文档并实现代码# 标签页 3 (审查者):cd E:\VSCodeProject\multi-agent-project claude你是审查专家请审查代码并输出报告到 docs/⚠️手动模式的局限性没有自动 Worktree 隔离、没有依赖链自动触发、没有 Diff 可视化。建议优先使用 Cline Kanban。总结本指南的推荐方式——只需npx kanban一个命令在浏览器看板中创建 3 个卡片设计/实现/审查CtrlClick 建立依赖链点击第一个的 ▶ Play。之后的 Agent 执行、Worktree 管理、Diff 审查、代码交付全部在 Cline Kanban 中一站完成。
核心理念通过Cline Kanban统一编排 3 个 AI Agent设计师 / 实现者 / 审查者每个角色作为一个任务卡片在独立 Git Worktree 中并行执行卡片间通过依赖链自动串联人类只需在浏览器看板上审查 Diff 和决策。一、架构总览1.1 统一编排模型Cline Kanban 任务面板 Agent 运行时 Worktree 管理器Cline Kanban不是贴在看板上的装饰层它是整个多 Agent 工作流的编排核心。它与传统手动方式的本质区别对比维度旧方式手动 3 终端新方式Cline Kanban启动 Agent手动开 3 个终端分别 cd 到不同 worktree在浏览器看板上点击卡片 ▶ 按钮Worktree 管理手动git worktree add/removeKanban 自动创建/清理临时 worktree任务依赖人工检查前置任务是否完成Ctrl点击链接卡片自动串联进度监控AltTab 切换 3 个终端窗口一个浏览器页面所有卡片状态一目了然代码审查手动 git diff手动写审查意见卡片内 Diff 查看器 行内评论合并交付手动 git merge / cherry-pick点击 Commit 或 Open PR 按钮┌──────────────────────────────────────────────────────────────────────┐ │ 浏览器 — Cline Kanban 看板 │ │ │ │ ┌──────────┐ CtrlClick ┌──────────┐ CtrlClick ┌──────────┐ │ │ │ 设计 │ ──────────→ │ 实现 │ ──────────→ │ 审查 │ │ │ │ 认证模块 │ 依赖链 │ 认证模块 │ 依赖链 │ 认证模块 │ │ │ │ │ │ │ │ │ │ │ │ Agent A │ │ Agent B │ │ Agent C │ │ │ │ 设计师 │ │ 实现者 │ │ 审查者 │ │ │ │ │ │ │ │ │ │ │ │ [▶ Play] │ │ ⏳ 等待中 │ │ ⏳ 等待中 │ │ │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ │ │ │ ├─────────┼──────────────────────────┼──────────────────────────┼───────┤ │ ▼ ▼ ▼ │ │ Git WorktreeKanban 自动管理每个卡片一个临时 worktree │ │ │ │ 卡片 设计认证模块 卡片 实现认证模块 卡片 审查认证模块 │ │ → 临时 worktree #1 → 临时 worktree #2 → 临时 worktree #3 │ │ → 独立 Git 分支 → 独立 Git 分支 → 独立 Git 分支 │ │ → 独立 node_modules → 独立 node_modules → 独立 node_modules│ │ │ │ Agent A 在此编码 Agent B 在此编码 Agent C 在此编码 │ │ Claude Code 自动运行 前置完成自动启动 前置完成自动启动│ │ │ ├──────────────────────────────────────────────────────────────────────┤ │ │ │ .agents/ 协议文件可选补充用于复杂的跨 Agent 设计文档共享 │ │ ├── design/ ← 设计产出物 │ │ ├── implementation/ ← 实现说明 │ │ └── review/ ← 审查报告 │ │ │ │ 注常规协作通过 Kanban 卡片 Diff 审查 行内评论完成 │ │ .agents/ 仅用于需要持久化保存的设计文档场景 │ └──────────────────────────────────────────────────────────────────────┘1.2 三角色定义映射为 3 个 Kanban 任务卡片角色Kanban 卡片自动 Worktree职责核心输出Agent A — 设计师卡片 “设计认证模块”Kanban 自动创建临时 worktree需求分析、架构设计、接口定义、技术选型设计文档Agent B — 实现者卡片 “实现认证模块”卡片 A 完成后自动创建编码实现、单元测试、Bug 修复代码 测试Agent C — 审查者卡片 “审查认证模块”卡片 B 完成后自动创建代码审查、安全审计、质量评估审查报告 行内评论关键理解你不需要为每个 Agent 手动分配 worktree 目录或分支。Cline Kanban 在你点击卡片 ▶ 按钮时自动创建临时 worktree完成后移到 Trash 自动清理。你只需要关心卡片描述里写什么提示词。1.3 技术选型理由组件角色为什么选它Cline Kanban统一编排层一站式管理任务创建→Agent 启动→Worktree 管理→Diff 审查→交付。零配置npx kanban启动兼容 Claude Code 作为 Agent 运行时Git Worktree内置隔离机制Cline Kanban 自动为每个卡片创建临时 worktreeAgent 互不干扰完成后自动清理.agents/ 文件协议可选补充通信当需要持久化设计文档或复杂跨角色引用时使用日常协作通过 Kanban 的 Diff 查看器 行内评论完成二、环境准备2.1 前置条件只需要三样东西# PowerShell / Git Bash 均可node--version# 需要 18Cline Kanban 依赖git--version# 任意版本claude--version# Claude Code 已安装# 进入你的 Git 项目Cline Kanban 必须在 git 仓库根目录启动cd/e/VSCodeProject/multi-agent-project⚠️注意Cline Kanban 必须在已有至少一个 commit 的 Git 仓库中启动。如果项目还是空的先git init git commit --allow-empty -m init。2.2 一键启动 Cline Kanban# 在项目根目录执行零配置自动安装依赖npx kanban浏览器自动打开http://127.0.0.1:port你将看到 Cline Kanban 看板界面。第一次启动时会弹出 Agent 选择对话框。选择Claude Code作为 Agent 运行时。之后可在 Settings 中随时更改。2.3 Cline Kanban 自动管理一切你不需要手动做的事你不需要…因为 Cline Kanban 自动…手动git worktree add点击卡片 ▶ 时自动创建临时 worktree手动git branch每个卡片自动分配独立分支手动开 3 个终端窗口Agent 在 worktree 内自动运行手动git merge/cherry-pick点击 Commit 或 Open PR 按钮手动git worktree remove卡片移到 Trash 自动清理创建 System Prompt 文件角色提示词直接写在卡片描述里2.4 可选创建 CLAUDE.md 注入项目上下文在项目根目录创建CLAUDE.md所有 Agent 启动时会自动读取# CLAUDE.md — Multi-Agent Project Context ## Project Overview 本项目使用 Cline Kanban 的 3-Agent 互审工作流。 - 卡片 1设计需求分析、架构设计、接口定义 - 卡片 2实现按设计编码、单元测试 - 卡片 3审查代码审查、安全审计、质量评估 ## Coding Standards - 遵循项目已有的代码风格 - 所有新函数需有文档注释 - 所有新功能需包含单元测试 - Commit message 遵循 conventional commits 格式 ## Tech Stack 根据你的项目填写三、Cline Kanban 实操创建 3 个 Agent 任务卡片这一章是你实际操作的步骤。不需要打开任何终端窗口——一切在浏览器看板中完成。3.1 启动看板如果还没开cd/e/VSCodeProject/multi-agent-project npx kanban3.2 首次启动选择 Agent 运行时第一次启动 Cline Kanban 时会弹出对话框让你选择使用哪个 CLI Agent在对话框中选择Claude Codeclaude确认选择后Cline Kanban 会记住这个配置存储在~/.cline/kanban/config.json后续启动不会再弹窗// ~/.cline/kanban/config.json{selectedAgentId:claude,agentAutonomousModeEnabled:false// 建议保持 false关键操作仍需你审批}3.3 创建第一个任务卡片设计师在看板的Backlog列中点击“ Add Task”或按快捷键c输入以下内容卡片标题设计用户认证模块卡片描述Prompt你是一名资深系统架构师设计师角色。请完成以下任务 需求实现一个用户认证模块支持 JWT Token 签发与校验。 请完成 1. 分析需求设计模块架构 2. 定义 API 接口端点、请求/响应格式 3. 定义数据模型数据库表结构、字段类型 4. 说明技术选型理由 5. 设计线程安全方案和错误处理策略 输出 - 设计文档保存为 docs/auth-design.md - 接口定义保存为 docs/auth-api.md点击Create创建卡片。3.4 创建第二个任务卡片实现者同样在 Backlog 列中点击“ Add Task”卡片标题实现用户认证模块卡片描述Prompt你是一名资深后端工程师实现者角色。请根据设计文档完成编码实现 1. 先阅读 docs/auth-design.md 和 docs/auth-api.md 了解设计 2. 按照设计规范实现代码到 src/ 目录 3. 编写完整的单元测试到 tests/ 目录 4. 如果发现设计中存在不可行、模糊或遗漏的地方 - 在代码中以 TODO/FIXME 注释标注 - 记录到 docs/impl-notes.md 要求 - 所有公开函数必须有文档注释 - 测试覆盖率不低于 80% - 遵循项目已有的代码风格点击Create创建卡片。3.5 创建第三个任务卡片审查者卡片标题审查用户认证模块卡片描述Prompt你是一名资深代码审查专家审查者角色。请执行以下审查任务 1. 阅读 docs/auth-design.md 了解设计意图 2. 审查 src/ 中的代码实现对照设计文档检查一致性 3. 检查 tests/ 的测试覆盖率 4. 检查安全漏洞OWASP Top 10 5. 检查性能问题算法复杂度、资源使用 审查报告格式 ## 概述 ## 严重问题必须修复才能合并 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTED 输出到 docs/review-report.md点击Create创建卡片。3.6 链接卡片形成依赖链这是 Cline Kanban 最强大的功能——Ctrl 点击链接卡片按住Ctrl 键点击卡片 “设计用户认证模块”然后点击卡片 “实现用户认证模块”一条依赖线建立设计 → 实现设计完成后实现自动启动重复操作Ctrl 点击“实现用户认证模块” → 再点击 “审查用户认证模块”第二条依赖线实现 → 审查实现完成后审查自动启动现在看板上应该是这样的依赖链 设计认证模块 ──→ 实现认证模块 ──→ 审查认证模块 (Backlog) (Backlog) (Backlog)3.7 启动工作流点击第一个卡片 “设计用户认证模块” 上的▶ Play 按钮。Cline Kanban 会自动为这个卡片创建一个临时 Git Worktree在 Worktree 中启动 Claude Code AgentAgent 读取卡片描述中的 Prompt 并开始工作卡片状态从 Backlog → In Progress你可以在卡片上看到 Agent 的最新消息/工具调用后续自动发生设计卡片完成 → 移到 Review 列 → 实现卡片自动启动▶实现卡片完成 → 移到 Review 列 → 审查卡片自动启动▶四、工作流程核心4.1 卡片生命周期Backlog待办 → In Progress进行中 → Review审查 → Trash已完成/清理 │ │ │ │ │ 点击 ▶ Play │ Agent 工作中 │ 你审查 Diff │ 点击 Commit │ 自动创建 Worktree │ 卡片显示最新输出 │ 行内评论反馈 │ 或 Open PR │ 启动 Claude Code │ │ │ 然后移到 Trash4.2 Phase 1: 设计师工作自动执行点击 ▶ 后卡片 “设计用户认证模块” 进入 In ProgressCline Kanban 自动创建临时 worktreeClaude Code 以设计师角色启动读取卡片描述中的 PromptAgent 分析需求、设计架构、编写 API 定义、数据模型你在看板上看到 Agent 的实时输出最新消息/工具调用Agent 完成后的操作卡片自动进入 Review 列你点击卡片 → 查看Diff所有文件变更如果设计不满意 → 在 Diff 行上点击添加行内评论→ 评论发送回 Agent 修改如果设计满意 → 依赖链触发卡片 “实现用户认证模块”自动启动▶4.3 Phase 2: 实现者工作自动启动设计卡片完成后实现卡片自动启动无需人工干预Cline Kanban 创建新的临时 worktreeClaude Code 以实现者角色启动Agent 先读取设计师产生的文件docs/auth-design.md然后开始编码src/目录 tests/目录如果发现设计问题Agent 会在代码中标注 TODO/FIXME4.4 Phase 3: 审查者工作自动启动实现完成后审查卡片自动启动Cline Kanban 创建新的临时 worktreeClaude Code 以审查者角色启动Agent 对照设计文档审查代码输出结构化审查报告4.5 Phase 4: 人类审查与交付三个卡片全部完成后你来最终审查逐个点击卡片→ 查看每个 Agent 的 Diff 和输出在 Diff 上留行内评论如果有问题→ Agent 会收到反馈并修改对于满意的卡片点击Commit→ Agent 自动将 Worktree 的变更合并到主分支或点击Open PR→ Agent 创建 Pull Request移到 Trash→ Worktree 被清理磁盘空间释放如果需要恢复 → 每个卡片有 resume ID可以恢复继续工作五、审查与互审机制在 Cline Kanban 中审查不是另开一个终端手动写报告——而是直接在看板 UI 中完成。5.1 三层审查体系┌─────────────────────────────────────────────────────────────┐ │ 第一层人类实时审查 │ │ │ │ 每个卡片完成后进入 Review 列 → 你点击卡片 → 查看 Diff │ │ → 在具体代码行上点击 → 留下行内评论 → Agent 收到反馈并修改 │ │ │ │ 这是最直接的审查方式所见即所得不经过中间文档 │ ├─────────────────────────────────────────────────────────────┤ │ 第二层Agent C 自动审查 │ │ │ │ 审查卡片的 Agent 自动对照设计文档审查代码 │ │ → 输出结构化审查报告docs/review-report.md │ │ → 标注严重/主要/次要问题 │ │ → 给出 APPROVED / NEEDS CHANGES / REJECTED 裁决 │ ├─────────────────────────────────────────────────────────────┤ │ 第三层可选交叉审查卡片 │ │ │ │ 如果需要设计师审查实现、实现者审查设计 │ │ → 在 Backlog 中创建额外审查卡片 │ │ → 写清楚请审查前面卡片的输出对照原始设计 │ │ → 不需要手动开终端不需要 protocol.md │ └─────────────────────────────────────────────────────────────┘5.2 实操如何审查一个卡片的输出卡片状态进入 Review 列后→ 点击卡片打开详情查看 Agent 的 TUI终端界面回放→ 了解 Agent 的思考过程查看 Diff所有文件变更→ 支持按 checkpoint消息范围分段查看在 Diff 行上点击→ 弹出评论框 → 输入反馈 → Agent 会收到并处理满意后→ 点击 Commit 合并到主分支或 Open PR 走 Pull Request 流程5.3 可选创建交叉审查卡片如果标准 3 卡片流程不够可以增加交叉审查卡片 “交叉审查实现是否符合设计”让设计师审查实现你是设计师。请审查前面 Agent 的实现是否忠于你的设计 1. 阅读 docs/auth-design.md你的设计 2. 查看仓库中 src/ 的实际代码 3. 找出任何设计偏差、遗漏的实现项 4. 对每个偏差标注文件路径和行号 5. 给出结论设计一致 / 存在偏差需修正 / 设计本身需要调整 输出到 docs/cross-review-designer.md卡片 “交叉审查设计的可实施性”让实现者审查设计你是实现者。请基于你的实现经验审查设计的可行性 1. 重新审视 docs/auth-design.md 2. 标注设计中模糊、遗漏、或过度设计的部分 3. 说明哪些设计决策在实现中遇到了困难 4. 给出结论设计可行 / 需要调整 / 需要重新设计 输出到 docs/cross-review-implementer.md创建后同样用 CtrlClick 链接到依赖链末端审查卡片完成后自动触发交叉审查。5.4 裁决与交付最终由你人类做裁决情况操作所有卡片审查通过点击 Commit → Agent 合并到主分支 → 卡片移到 Trash有小问题需要修改在 Diff 上留行内评论 → Agent 修改 → 重新审查有大问题创建新卡片修复 → 链接到问题卡片后面设计需要大改在 “设计” 卡片 Diff 上评论 → 要求 Agent 重新设计 → 下游卡片自动感知变更六、Git Worktree 原理Cline Kanban 自动管理⚠️本节是理解性内容。你不需要手动操作任何 worktree 命令——Cline Kanban 已经自动处理一切。以下内容帮助你理解背后的机制。6.1 Cline Kanban 如何使用 Worktree当你点击 Kanban 卡片上的 ▶ 按钮时Cline Kanban 自动执行以下操作为这个卡片创建一个临时ephemeralGit WorktreeWorktree 位于项目目录外的临时位置拥有独立的分支AgentClaude Code在这个 worktree 中运行修改互不干扰当你把卡片移到 Trash 时worktree 自动被清理你的项目目录 Cline Kanban 自动管理 E:\VSCodeProject\ 你看不到也不需要关心 multi-agent-project/ ├── .git/ ← 共享 临时 worktree #1 → 卡片 设计认证模块 ├── src/ 临时 worktree #2 → 卡片 实现认证模块 └── docs/ 临时 worktree #3 → 卡片 审查认证模块 ↑ Cline Kanban 在卡片启动时自动创建 卡片移到 Trash 时自动删除6.2 关键优化node_modules 符号链接Cline Kanban 会自动将主仓库中的node_modules等 gitignored 文件符号链接到每个 worktree 中。这意味着不需要为每个 Agent 重新npm installAgent 看不到其他 Agent 的 node_modules 修改但如果 Agent 需要修改 gitignored 文件如安装新包变化会影响主仓库的副本6.3 你需要知道的 Git 命令仅用于排查# 查看当前所有 worktree包括 Kanban 自动创建的gitworktree list# 如果 Kanban 崩溃或异常退出可能有残留 worktree# 手动清理谨慎确保没有 Agent 正在运行gitworktree prune七、Cline Kanban 完整操作参考7.1 什么是 Cline KanbanCline Kanban 是 Cline 生态中的多 Agent 编排看板。它是一个本地浏览器应用通过npx kanban一键启动零配置。核心能力说明任务看板Backlog → In Progress → Review → Trash 四列式管理一键启动 Agent点击卡片 ▶ 按钮自动创建 worktree 并启动 Claude Code依赖链CtrlClick 链接卡片前置完成自动触发后续Diff 审查点击卡片查看完整 Diff支持 checkpoint 分段浏览行内评论在 Diff 任意行点击评论反馈直达 Agent一键交付Commit 合并到主分支或 Open PR 走审查流程Sidebar Chat内置聊天 Agent可帮你拆分任务并自动建卡片多 CLI Agent 兼容支持 Claude Code、Cline CLI、Codex、OpenCode 等7.2 安装与启动# 全局安装可选安装后可直接用 kanban 命令npmi-gkanban# 或直接 npx 启动推荐无需安装cd/e/VSCodeProject/multi-agent-project npx kanban# 浏览器自动打开 → http://127.0.0.1:port7.3 首次配置选择 Agent 运行时第一次启动 Cline Kanban 会弹出 Agent 选择对话框选择Claude Codeclaude确认后配置保存到~/.cline/kanban/config.json{selectedAgentId:claude,agentAutonomousModeEnabled:false}agentAutonomousModeEnabled: false→ 关键操作需要你审批推荐agentAutonomousModeEnabled: true→ Agent 完全自主执行适合信任度高的任务后续可在界面右上角Settings按钮中更改。7.4 看板列说明列含义操作Backlog待办任务点击 “” 新建卡片或从 Sidebar Chat 让 Agent 自动拆分In Progress正在执行Agent 在此列中运行卡片显示最新消息/工具调用Review等待人类审查Agent 完成任务后进入此列点击卡片查看 DiffTrash已完成/已清理移到此处自动清理 worktree释放磁盘。每个卡片保留 resume ID 可恢复7.5 快捷键快捷键操作c创建新卡片Ctrl Click卡片 A → 卡片 B链接卡片A 完成后 B 自动启动Delete删除选中卡片7.6 卡片 Prompt 编写技巧Cline Kanban 中每个卡片的描述Prompt就是该 Agent 的 System Prompt。写好 Prompt 是整个工作流质量的关键✅ 好的 Prompt 你是一名资深后端工程师。请按照 docs/auth-design.md 的设计实现用户认证模块。 要求1) JWT 签发和校验 2) 密码 bcrypt 加密 3) 单元测试覆盖率 80% ❌ 差的 Prompt 实现用户认证Prompt 模板设计师你是一名资深系统架构师。请完成 [功能名称] 的设计 需求[具体需求描述] 请完成 1. 模块架构设计含架构图描述 2. API 接口定义端点、请求/响应格式、错误码 3. 数据模型设计表结构、字段类型、索引 4. 技术选型及理由 5. 安全与性能考量 输出文件docs/[feature]-design.md, docs/[feature]-api.mdPrompt 模板实现者你是一名资深工程师。请按照设计文档实现 [功能名称] 1. 先阅读 docs/[feature]-design.md 了解设计 2. 严格按照设计规范编码 3. 编写完整的单元测试 4. 如果发现设计问题在代码中以 TODO/FIXME 标注并记录到 docs/impl-notes.md 要求所有公开函数有文档注释测试覆盖率 80%Prompt 模板审查者你是一名资深代码审查专家。请审查 [功能名称] 的实现 1. 阅读 docs/[feature]-design.md 了解设计意图 2. 对照设计审查代码实现 3. 检查安全漏洞OWASP Top 10 4. 检查性能和代码质量 审查报告格式输出到 docs/review-[feature].md ## 概述 ## 严重问题必须修复 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTED7.7 Cline Kanban 配置文件说明// ~/.cline/kanban/config.json{selectedAgentId:claude,// Agent 运行时claude / cline / codex / opencodeagentAutonomousModeEnabled:false// false关键操作需审批, true全自主}7.8 Cline Kanban 数据存储数据位置看板配置~/.cline/kanban/config.json卡片数据~/.cline/kanban/workspaces/hash/boards.json临时 Worktree系统临时目录Kanban 自动管理7.9 Sidebar Chat用 Agent 自动拆任务Cline Kanban 内置一个 Sidebar Chat Agent你可以对它说“我有一个项目需要实现用户认证功能帮我拆分成设计、实现、审查三个任务卡片并链接起来”Sidebar Agent 会自动创建卡片、填写合适的 Prompt、并建立依赖链。这是最快的启动方式。八、进阶优化8.1 使用 Sidebar Chat 自动拆任务最快启动方式不看板手动创建卡片直接打开 Kanban 的 Sidebar Chat对内置 Agent 说“我有一个项目需要实现用户认证功能包含 JWT 签发校验、密码加密、Token 刷新。帮我拆分成设计、实现、审查三个任务链接起来并给每个卡片填好合适的 Prompt。”Sidebar Agent 会自动完成创建 3 个卡片填写角色化的 Prompt建立 CtrlClick 依赖链你只需点击第一个卡片的 ▶ 按钮8.2 使用 CLAUDE.md 注入项目上下文在项目根目录创建CLAUDE.mdKanban 启动的每个 Agent 都会自动读取# CLAUDE.md — Multi-Agent Project Context ## Project Overview 本项目使用 Cline Kanban 的 3-Agent 互审工作流。 卡片通过 CtrlClick 建立依赖链设计 → 实现 → 审查 ## Communication - 前置卡片的输出在 docs/ 目录中后续卡片需先读取 - 发现问题时在代码中以 TODO/FIXME 标注并记录到 docs/impl-notes.md ## Directory Structure - docs/ — 设计文档、API 定义、审查报告 - src/ — 源代码 - tests/ — 测试文件 ## Coding Standards - 遵循项目已有代码风格 - 所有公开函数必须有文档注释 - 所有新功能必须包含单元测试 - Commit message 遵循 conventional commits 格式8.3 全局安装 Cline Kanban更快启动# 全局安装后直接用 kanban 命令启动无需每次 npx 下载npmi-gkanban# 之后在任何 git 项目中直接kanban8.4 Cline Kanban CI/CD 集成Cline Kanban 支持通过 CLI 在 CI/CD 中运行 Agent# .github/workflows/agent-review.ymlname:Agent Code Reviewon:[pull_request]jobs:review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-name:Run Agent Reviewrun:|npx kanban --headless --task 审查本 PR 的代码变更对照设计文档输出审查报告 \ --agent claude九、实际操作 Demo完整示例以下是以实现一个任务队列模块为例的完整 Cline Kanban 操作流程。Step 1: 启动 Cline Kanbancd/e/VSCodeProject/multi-agent-project npx kanban# 浏览器自动打开看板Step 2: 创建三个卡片按c键或点击 “”依次创建卡片 1: “设计任务队列模块”Prompt:你是一名资深系统架构师。请设计一个任务队列模块 需求 - 支持优先级队列 - 支持任务超时取消 - 线程安全 - 提供 C API 请完成 1. 模块架构设计含模块间关系描述 2. API 接口定义函数签名、参数、返回值、错误码 3. 数据结构设计队列节点、任务描述符等 4. 线程安全方案锁策略、无锁方案评估 5. 性能考量时间复杂度分析 输出文件docs/task-queue-design.md, docs/task-queue-api.md卡片 2: “实现任务队列模块”Prompt:你是一名资深 C 工程师。请实现任务队列模块 1. 先阅读 docs/task-queue-design.md 和 docs/task-queue-api.md 2. 按设计实现代码到 src/task_queue.c 和 src/task_queue.h 3. 编写完整单元测试到 tests/test_task_queue.c 4. 如果发现设计问题在代码中以 TODO/FIXME 标注记录到 docs/impl-notes.md 要求所有公开函数有文档注释测试覆盖率 80%卡片 3: “审查任务队列模块”Prompt:你是一名资深代码审查专家。请审查任务队列模块 1. 阅读 docs/task-queue-design.md 了解设计意图 2. 审查 src/task_queue.c 和 src/task_queue.h 3. 审查 tests/test_task_queue.c 的覆盖率 4. 检查线程安全问题死锁、竞态条件、数据竞争 5. 检查内存管理泄漏、越界、double-free 审查报告格式输出到 docs/review-task-queue.md ## 概述 ## 严重问题必须修复才能合并 ## 主要问题应该修复 ## 次要问题可以后续优化 ## 正面评价 ## 裁决APPROVED / NEEDS CHANGES / REJECTEDStep 3: 建立依赖链按住Ctrl先点击卡片 1再点击卡片 2 → 链接建立按住Ctrl先点击卡片 2再点击卡片 3 → 链接建立Step 4: 启动点击卡片 1 的▶ Play按钮。Cline Kanban 自动完成卡片 1 → In Progress → Agent 设计师工作卡片 1 完成 → Review 列 → 卡片 2自动启动卡片 2 完成 → Review 列 → 卡片 3自动启动你无需做任何操作等着看结果Step 5: 审查与交付所有卡片进入 Review 列后逐个点击查看 Diff对不满意的代码行添加评论 → Agent 收到反馈修改全部满意后 → 点击Commit或Open PR所有卡片移到Trash→ Worktree 自动清理十、注意事项与最佳实践10.1 Cline Kanban 注意事项问题说明Kanban 依赖 Git 仓库项目必须有至少一个 commit空仓库需先git commit --allow-empty -m init卡片 Prompt 即 System Prompt卡片描述的质量直接决定 Agent 输出质量参考 7.6 节的模板agentAutonomousModeEnabled建议保持false关键操作如 git push、删除文件需要你审批卡片移到 Trash 不可逆虽然有 resume ID但恢复不一定完整。确认交付后再 Trash多个 Agent 不能同时修改同一文件如果两个卡片的 Prompt 都需要修改 src/main.c先完成第一个再启动第二个10.2 Prompt 编写最佳实践明确角色第一句就说明 “你是一名资深 XX 工程师”具体输入明确告诉 Agent 去哪里读前置文档如docs/auth-design.md具体输出指定输出文件路径和格式限制范围不要让一个卡片做太多事一个卡片一个职责包含验收标准如 “测试覆盖率 80%”、“所有公开函数有文档注释”10.3 Windows 环境特别注意事项注意事项说明Node.js 版本Cline Kanban 需要 Node.js 18Git 路径确保git在 PATH 中可用首次 npx 较慢首次npx kanban需要下载依赖后续会快很多或npm i -g kanban一劳永逸claude 命令确保claude在 PATH 中如果不在Cline Kanban 的 Settings 中可指定完整路径编码问题所有.md文件统一用 UTF-8 编码避免中文乱码防火墙npx kanban启动本地服务器如弹窗询问网络访问点击允许10.4 适用于不同规模项目的配置项目规模推荐配置小型单模块1k 行npx kanban 3 个卡片 手动 CtrlClick 链接中型多模块1k-10k 行npx kanban Sidebar Chat 拆任务 CLAUDE.md 交叉审查卡片大型多模块10k 行npx kanban Sidebar Chat CLAUDE.md CI/CD 集成 自定义 Prompt 模板库十一、快速启动 Checklist□ 1. 确保 Node.js 18 (node --version) □ 2. 确保 Git 仓库已初始化并至少有 1 个 commit □ 3. 确保 Claude Code 已安装 (claude --version) □ 4. cd 到项目根目录 □ 5. 启动 Cline Kanban (npx kanban) — 浏览器自动打开 □ 6. 首次启动选择 Agent 类型为 Claude Code □ 7. (可选) 用 Sidebar Chat 说帮我拆分 XXX 功能为设计、实现、审查三个卡片 □ 8. (或手动) 按 c 键创建 3 个卡片填写角色 Prompt □ 9. CtrlClick 链接卡片设计 → 实现 → 审查 □ 10. 点击第一个卡片的 ▶ Play 按钮 □ 11. 所有卡片完成 → Review 列 → 逐个点击查看 Diff □ 12. 在 Diff 上留行内评论如果有问题 □ 13. 点击 Commit 或 Open PR □ 14. 所有卡片移到 Trash十二、扩展思路12.1 扩展到更多 Agent在 Cline Kanban 中扩展非常简单——多创建几个卡片并链接卡片: 安全审计 → 卡片: 性能优化 → 卡片: 文档生成 (Agent D) (Agent E) (Agent F)新角色卡片 Prompt 要点安全审计专家专注 OWASP Top 10 漏洞扫描、依赖安全审计、密钥泄露检测性能优化专家专注 profiling、内存优化、算法复杂度优化、缓存策略文档工程师专注 API 文档、用户指南、CHANGELOG、README 更新12.2 自定义 Prompt 模板库在项目docs/prompts/目录维护常用 Prompt 模板docs/prompts/ ├── designer-template.md ← 设计师 Prompt 模板 ├── implementer-template.md ← 实现者 Prompt 模板 ├── reviewer-template.md ← 审查者 Prompt 模板 ├── security-auditor.md ← 安全审计 Prompt 模板 └── perf-optimizer.md ← 性能优化 Prompt 模板创建卡片时直接复制模板内容替换[功能名称]等占位符。12.3 与 CI/CD 集成# .github/workflows/multi-agent-review.ymlname:Multi-Agent Reviewon:[pull_request]jobs:review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-uses:actions/setup-nodev4with:node-version:18-name:Run Agent Review via Kanbanrun:|npx kanban --headless --task 审查本 PR输出审查报告到 docs/pr-review.md --agent claude-name:Check Verdictrun:|grep -q REJECTED docs/pr-review.md echo Review rejected exit 1 || echo Review passed十三、附录 A: 手动 3-Session 模式备选方案如果你无法使用 Cline Kanban或需要更精细的手动控制以下是最简化的手动方案# 在一个 PowerShell 窗口分 3 个标签页# 标签页 1 (设计师):cd E:\VSCodeProject\multi-agent-project claude你是系统架构师请设计 XXX 功能。输出设计文档到 docs/# 标签页 2 (实现者):cd E:\VSCodeProject\multi-agent-project claude你是工程师请阅读 docs/ 中的设计文档并实现代码# 标签页 3 (审查者):cd E:\VSCodeProject\multi-agent-project claude你是审查专家请审查代码并输出报告到 docs/⚠️手动模式的局限性没有自动 Worktree 隔离、没有依赖链自动触发、没有 Diff 可视化。建议优先使用 Cline Kanban。总结本指南的推荐方式——只需npx kanban一个命令在浏览器看板中创建 3 个卡片设计/实现/审查CtrlClick 建立依赖链点击第一个的 ▶ Play。之后的 Agent 执行、Worktree 管理、Diff 审查、代码交付全部在 Cline Kanban 中一站完成。
