## 平台支持状态（当前）平台|当前支持|要求 ---|---|--- 克劳德|原生 MCP 集成 |在`mcpServers`中注册法典| MCP 脚本集成 | `scripts/mcp-setup.sh --codex` 或等效配置双子座| MCP注册| `mcpServers`/桥配置开放代码 | MCP/桥集成| `omx`/`ohmg` 或等效设置仅此技能是否足够： * 克劳德/双子座：**是** * Codex：**是（需要基于脚本的设置）** * OpenCode：**是（通过编排）** # Vibe Kanban — AI 代理看板 > 从单个看板管理多个 AI 代理（Claude/Codex/Gemini）。将卡片（任务）移至“进行中”会自动创建 git 工作树并启动代理。 ## 什么时候使用这个技能 * 将史诗分解为独立任务以进行并行代理分配时 * 当您想要直观地跟踪正在进行的 AI 工作的状态时 * 当您想要在 UI 中以差异/日志形式查看代理结果并重试时 * 将基于 GitHub PR 的团队协作与 AI 代理工作相结合时 ** ** ## 先决条件 # 需要 Node.js 18+ 节点--版本 # 预先完成代理认证 claude --version # 设置 ANTHROPIC_API_KEY codex --version # 设置 OPENAI_API_KEY （可选） gemini --version # 设置 GOOGLE_API_KEY （可选） opencode --version # 无需单独设置（基于 GUI） > **验证版本（截至 2026 年 2 月 22 日）** > > * 振动看板：v0.1.17 > * 克劳德（克劳德代码）：2.1.50 > * 法典：0.104.0 > * 双子座：0.29.5 > * 开放代码：1.2.10 > ** ** ## 安装与运行 ### npx（最快） # 立即运行（无需安装） npx 振动看板 # 指定端口（默认端口3000） npx vivi-kanban --端口 3001 # 一起指定端口和环境变量 PORT=3001 npx vivi-kanban --端口 3001 # 使用包装脚本 bash 脚本/vibe-kanban-start.sh 浏览器自动打开“http://localhost:3000”。 > ⚠️ **端口冲突警告**：如果像 Next.js 这样的另一个开发服务器正在使用端口 3000，请运行 `PORT=3001 npx vivi-kanban --port 3001`。确认启动日志中的“Main server on :3001”，然后访问“http://localhost:3001”。正常启动日志：启动 vivi-kanban v0.1.17... 未找到用户 profile.json，仅使用默认值启动PR监控服务，间隔60秒使用 URL 初始化远程客户端：https://api.vibekanban.com 主服务器位于：3001，预览代理位于：XXXXX 正在打开浏览器... ### 克隆+开发模式 git 克隆 https://github.com/BloopAI/vibe-kanban.git cd 振动看板 PNPM我 pnpm 运行开发 ** ** ## 环境变量变量|描述 |默认 ---|---|--- `端口` |服务器端口 | `3000` `主机` |服务器主机| `127.0.0.1` `VIBE_KANBAN_REMOTE` |允许远程连接 | `假` `VK_ALLOWED_ORIGINS` | CORS 允许的来源 |未设置 `DISABLE_WORKTREE_CLEANUP` |禁用工作树清理 |未设置 `ANTHROPIC_API_KEY` |对于克劳德·科德经纪人| — `OPENAI_API_KEY` |对于 Codex/GPT 代理 | — `GOOGLE_API_KEY` |对于双子座代理| — 在启动服务器之前在`.env`文件中设置。 > **每个代理的 API 密钥位置（设置 → 代理 → 环境变量）** > > * 克劳德代码：`ANTHROPIC_API_KEY` > * 法典：`OPENAI_API_KEY` > * 双子座：`GOOGLE_API_KEY` > * Opencode：无需单独设置（内置身份验证） > ** ** ## MCP 配置 Vibe 看板作为 MCP（模型上下文协议）服务器运行，让代理直接控制看板。 ### 克劳德代码 MCP 设置 `~/.claude/settings.json` 或项目 `.mcp.json`： { “mcp服务器”：{ “氛围看板”：{ “命令”：“npx”， “args”：[“vibe-看板”，“--mcp”]， “环境”：{ "MCP_HOST": "127.0.0.1", “MCP_PORT”：“3001” } } } } ### OpenCode MCP 设置添加到`~/.config/opencode/opencode.json`： { “MCP”：{ “氛围看板”：{ “命令”：“npx”， “args”：[“vibe-看板”，“--mcp”]， “环境”：{ "MCP_HOST": "127.0.0.1", “MCP_PORT”：“3001” } } } } 重新启动后，“vk_*”工具可直接在 OpenCode 会话中使用。 ### MCP 工具列表工具|描述 ---|--- `vk_list_cards` |列出所有卡（工作区） `vk_create_card` |创建一张新卡 `vk_move_card` |更改卡状态 `vk_get_diff` |获取卡差异 `vk_retry_card` |重新办卡 > ⚠️ **旧版本的工具名称更改**：`vk_list_tasks` → `vk_list_cards`、`vk_create_task` → `vk_create_card` 这些是自 v0.1.17 起实际 MCP API 确认的工具名称。 ### Codex MCP 集成要将 Vibe Kanban 与 Codex 连接，请从项目根目录运行以下命令： bash 脚本/mcp-setup.sh --codex 此命令将 `vibe-kanban` MCP 服务器配置添加到 `~/.codex/config.toml`。基于钩子的自动循环不是默认的 Codex 行为，因此重试/循环管理是通过板卡进度状态或更高级别的协调器来处理的。 ** ** ## 工作空间 → 并行代理 → PR 工作流程 > **v0.1.17 实际 UI 结构**：Vibe Kanban 是看板，但实际工作单元是 **工作空间**。每个工作区独立处理一项任务。 ### 1\.启动服务器 # 默认运行 npx 振动看板 # → http://localhost:3000 # 端口冲突（例如 Next.js） PORT=3001 npx vivi-kanban --端口 3001 # → http://localhost:3001 ### 2\. （可选）使用 planno 查看史诗计划使用 planno 查看此功能的实施计划 planno（规划器）是一项独立技能——无需 Vibe 看板即可使用。 ### 3\.创建工作区 1. 打开UI→点击**“+创建工作空间”**或左侧边栏中的`+`按钮 2. **哪个存储库？** 屏幕： * **浏览** → 从文件系统中选择一个 git 存储库（支持手动路径输入） * **最近** → 以前使用过的存储库 * 选择一个存储库，然后选择一个分支（默认：`main`） * 点击**继续** 3. **您想从事什么工作？** 屏幕： * 选择一个代理（Opencode、Claude Code、Codex、Gemini、Amp、Qwen Code、Copilot、Droid、Cursor Agent） * 输入任务描述（支持 Markdown） * 选择一种模式（默认、构建等） * 点击**创建** ### 4\.自动代理执行创建工作区时： * 自动创建 `vk/-` 分支（例如，`vk/3816-add-a-comment-to`） * 自动创建 git 工作树（每个代理完全隔离） * 所选代理 CLI 运行日志流工作区状态： * **正在运行** ：代理正在执行（左侧边栏） * **空闲**：等待 * **需要注意** ：代理已完成或需要输入 ### 5\.审核结果 * **更改面板**：查看文件差异 * **日志面板** ：代理执行日志 * **预览面板**：Web 应用程序预览 * **终端** : 直接运行命令 * **笔记** : 写笔记 ### 6\.创建公关并完成 * 工作区详细信息 → **“打开拉取请求”** 按钮 * PR 合并 → 工作区移至存档 * 工作树自动清理 ** ** ## Git Worktree 隔离结构工作区目录（可在“设置”→“常规”→“工作区目录”中配置）： ~/.vibe-kanban-workspaces/ ← 默认位置（在主目录下） ├── / ← 工作空间1隔离环境 ├── / ← 工作空间2隔离环境 └── / ← 工作空间3隔离环境分支命名（可在“设置”→“常规”→“Git”→“分支前缀”中配置）： vk/<4 个字符 ID>-<任务段> 例如：vk/3816-add-a-comment-to-readme 内部行为： git worktree add <工作空间目录> -b vk/- main -p "<任务描述>" --cwd <工作空间目录> > **推荐的 .gitignore 条目：** > > > .vibe-看板-工作空间/ > .vibe-看板/ > ** ** ## 远程部署 ### 码头工人 # 官方图片 docker run -p 3000:3000 vibekanban/vibe-kanban # 传递环境变量 docker run -p 3000:3000 \ -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \ -e VK_ALLOWED_ORIGINS=https://vk.example.com \ 振动看板 ### 反向代理（Nginx/Caddy） # 必须允许 CORS VK_ALLOWED_ORIGINS=https://vk.example.com # 或者多个来源 VK_ALLOWED_ORIGINS=https://a.example.com,https://b.example.com ### SSH 远程访问与 VSCode 远程 SSH 集成： vscode://vscode-remote/ssh-remote+user@host/path/to/.vk/trees/ ** ** ## 故障排除 ### 工作树冲突/孤立工作树 # 清理孤立的工作树 git worktree 修剪 # 列出当前工作树 git 工作树列表 # 强制删除特定的工作树 git worktree 删除 .vk/trees/ --force ### 403 禁止（CORS 错误） # 远程访问需要CORS配置 VK_ALLOWED_ORIGINS=https://your-domain.com npx vivi-kanban ### 代理无法启动 # 直接测试CLI 克劳德--版本法典--版本 # 检查 API 密钥回显 $ANTHROPIC_API_KEY 回显$OPENAI_API_KEY ### 端口冲突 # 使用不同的端口 npx vivi-kanban --端口 3001 # 或者使用环境变量 PORT=3001 npx vivi-看板 ### SQLite 锁定错误 # 禁用工作树清理并重新启动 DISABLE_WORKTREE_CLEANUP=1 npx vivi-看板 ** ** ## UI 与 CLI 决策指南情况|模式 ---|--- 共享团队看板，可视化进度跟踪 | UI（`npx vivi-看板`） CI/CD 管道、脚本自动化 | CLI（`脚本/pipeline.sh`）快速本地实验| CLI（`脚本/conductor.sh`）浏览器差异/日志审查 |用户界面 ** ** ## 支持的代理（已验证 v0.1.17）在“设置”→“代理”中配置每个代理：代理|命令 | API密钥 ---|---|--- **开放代码** | `开放代码` |内置（默认） **克劳德·代码** | '克劳德' | `ANTHROPIC_API_KEY` **法典** | `法典` | `OPENAI_API_KEY` **双子座** | `双子座` | `GOOGLE_API_KEY` **放大器** | `amp` |分开 **Qwen 代码** | `qwen-编码器` |分开 **副驾驶** | `副驾驶` | GitHub 帐户 **机器人** | `机器人` |分开 **光标代理** | `光标` |游标订阅每个代理可配置： * **附加提示** ：在代理运行时附加的附加指令 * **模型** ：要使用的模型名称（例如“claude-opus-4-6”） * **变体**：型号变体 * **自动批准** ：自动批准代理操作（默认值：开） * **自动压缩** ：自动压缩上下文（默认值：开） * **环境变量**：API 密钥和其他环境变量 ## 代表性用例 ### 1\.并行史诗分解 “支付流程v2”史诗 ├── 工作区1：前端UI → 克劳德代码 ├── 工作区2：后端API → Codex └── 工作区 3：集成测试 → Opencode → 3 个工作空间同时运行 → 并行实施 ### 2\.基于角色的专家代理分配克劳德代码 → 设计/领域密集型功能法典 → 类型/测试/重构双子座 → 文档/故事书写作 Opencode → 常规任务（默认） ### 3\.基于 GitHub PR 的团队协作设置 VIBE_KANBAN_REMOTE=true → 团队成员在看板上查看状态 → 仅通过 GitHub PR 审核/批准 → 平行代理+传统PR流程相结合 ### 4\.实施比较相同的任务，两个工作区：工作区 A → Claude 代码（UI 结构重点）工作区B→Codex（性能优化重点） → 比较 PR，选择两者中最好的 ### 5\. OpenCode + ulw 并行委托与 OpenCode 的 ulw（ultrawork）模式相结合，以史诗级别并行运行代理： # ulw 关键字 → 激活 ultrawork 并行执行层 # Vibe 看板：npx vibe-kanban（在单独的终端中运行）任务（类别=“视觉工程”，run_in_background=True， load_skills=["frontend-ui-ux", "vibe-kanban"], 描述 =“[看板 WS1] 前端 UI”， prompt="在 src/components/ payment/ 中实现支付流程 UI — 卡输入、订单确认和完成屏幕") 任务（类别=“未指定高”，run_in_background=True， load_skills=["vibe-看板"], description="[看板 WS2] 后端 API", Prompt="实现支付流程API — POST /charge、POST /refund、GET /status/:id") 任务（类别=“未指定低”，run_in_background=True， load_skills=["vibe-看板"], description="[看板 WS3] 集成测试", 提示=“编写支付E2E测试——成功/失败/退款场景”） # → 3 个工作区同时出现在看板上的运行状态 # → 每次完成时：需要注意 → 创建 PR → 存档 ** ** ## 提示 * 缩小卡片范围（1 张卡片 = 1 个提交单元） * 对于跨越 2 个以上文件的更改，请先使用 planno 查看计划 * 仅在可信网络上使用“VIBE_KANBAN_REMOTE=true” * 如果代理拖延，重新分配或拆分卡 ** ** ## 架构概述 ┌──────────────────────────────────────────────────────────┐ │ Vibe 看板 UI │ │ ┌──────────┬──────────┬──────────┬──────────┐ │ │ │ 待办事项 │ 进行中 │ 回顾 │ 已完成 │ │ └──────────┴──────────┴──────────┴──────────┘ │ └────────────────────────────┬──────────────────────────────┘ │ 休息API ┌────────────────────────────▼──────────────────────────────┐ │ Rust 后端 │ │ ┌──────────┐ ┌────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 服务器 │ │ 执行者 │ │ git │ 服务 │ │ │ └──────────┘ └────────┘ └──────────┘ └──────────┘ │ │ │ │ │ ┌──────▼──────┐ │ │ │ SQLite │ │ │ └────────────┘ │ └──────────────────────────────────────────────────────────┘ │ ┌────────────────────┼────────────────────┐ │ │ │ ┌────▼────┐ ┌──────▼────┐ ┌────▼────┐ │ 克洛德 │ │ 法典 │ │ 双子座 │ │工作树1│ │ 工作树2 │ │工作树3 │ └──────────┘ └────────────┘ └──────────┘ ** ** ## 参考文献 * [GitHub 仓库：BloopAI/vibe-kanban]() * [官方登陆页面：vibekanban.com]() * [架构分析：vibe-kanban——AI代理的看板]() * [收养故事]() * [演示：在没有 Git 冲突的情况下运行多个 Claude 代码代理]() * [演示：克劳德代码变得更好了 | Auto Claude 看板]() ** ** ## 技能文件结构 .agent-skills/vibe-kanban/ ├── SKILL.md # 主要技能文档 ├── SKILL.toon # TOON 格式（压缩） ├── 脚本/ │ ├── start.sh # 服务器启动包装器 │ ├── cleanup.sh # 工作树清理 │ ├── mcp-setup.sh # MCP 设置自动化 │ └── health-check.sh # 服务器健康检查 ├── 参考资料/ │ ├──environment-variables.md # 环境变量参考 │ └── mcp-api.md # MCP API 参考 └── 模板/ ├── claude-mcp-config.json # 克劳德代码 MCP 配置 ├── docker-compose.yml # Docker部署模板 └── .env.example # 环境变量示例 ### 脚本用法 # 启动服务器 bash 脚本/start.sh --端口 3001 # 工作树清理 bash 脚本/cleanup.sh --dry-run # 预览 bash script/cleanup.sh --all # 删除所有 VK 工作树 #MCP 设置 bash script/mcp-setup.sh --claude # Claude 代码设置 bash script/mcp-setup.sh --all # 所有代理的设置 # 健康检查 bash 脚本/health-check.sh bash脚本/health-check.sh --json # JSON输出 ** ** ## 快速参考 ===启动服务器=== npx vivi-kanban 立即运行（端口 3000） PORT=3001 npx vivi-kanban --port 3001 端口冲突（例如 Next.js） http://localhost:3000 板用户界面 ===环境变量=== PORT=3001 更改端口 VK_ALLOWED_ORIGINS=https://... 允许 CORS ANTHROPIC_API_KEY=... 克劳德代码验证 OPENAI_API_KEY=... 法典认证 GOOGLE_API_KEY=... Gemini 身份验证 === MCP 集成 === npx vivi-kanban --mcp MCP 模式 vk_list_cards 列出卡片（工作区） vk_create_card 创建卡片 vk_move_card 更改状态 === 工作区流程 === 创建 → 运行 → 需要注意 → 存档运行：工作树创建+代理启动需要注意：已完成或需要输入存档：PR 合并完成 === MCP 配置文件位置 === 打开代码：~/.config/opencode/opencode.json 克劳德代码：~/.claude/settings.json 或 .mcp.json ===工作树清理=== git worktree prune 清理孤儿 git worktree list 列出所有 git worktree remove 强制删除

坎的氛围

包含技能