vibe-kanban

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

플랫폼별 적용 상태 (현재 지원 기준)

各平台适配状态（当前支持标准）

플랫폼	현재 지원 방식	적용 조건
Claude	네이티브 MCP 연동	`mcpServers` 등록
Codex	MCP 스크립트 연동	`scripts/mcp-setup.sh --codex` 또는 동일 설정
Gemini	MCP 등록	`mcpServers` /브릿지 구성
OpenCode	MCP/브릿지 연동	`omx` / `ohmg` 류 또는 동등 구성

현재 스킬만

으로 가능한지:

Claude/Gemini: 가능
Codex: 가능(스크립트 기반 설정 필요)
OpenCode: 가능(오케스트레이션 경유)

平台	当前支持方式	适用条件
Claude	原生MCP联动	注册 `mcpServers`
Codex	MCP脚本联动	执行 `scripts/mcp-setup.sh --codex` 或同等配置
Gemini	MCP注册	配置 `mcpServers` /桥接
OpenCode	MCP/桥接联动	配置 `omx` / `ohmg` 类工具或同等结构

仅使用当前技能是否可行：

Claude/Gemini：可行
Codex：可行（需基于脚本配置）
OpenCode：可行（需通过编排中转）

Vibe Kanban — AI 에이전트 칸반 보드

Vibe Kanban — AI Agent Kanban看板

여러 AI 에이전트(Claude/Codex/Gemini)를 하나의 Kanban 보드에서 통합 관리합니다. 카드(태스크)를 In Progress로 옮기면 git worktree 생성 + 에이전트 실행이 자동 시작됩니다.

在单个Kanban看板中统一管理多个AI Agent（Claude/Codex/Gemini）。将卡片（任务）移至In Progress状态时，会自动启动git worktree创建+Agent执行流程。

When to use this skill

何时使用此技能

에픽을 여러 독립 태스크로 분해해 에이전트에게 병렬 할당할 때
진행 중인 AI 작업 상태를 시각적으로 추적하고 싶을 때
에이전트 결과를 UI에서 diff/로그로 리뷰하고 재시도하고 싶을 때
GitHub PR 기반 팀 협업과 AI 에이전트 작업을 결합할 때

将史诗需求拆解为多个独立任务并并行分配给Agent时
需要可视化追踪AI任务的执行状态时
希望在UI中通过diff/日志审核Agent结果并重新执行时
要将基于GitHub PR的团队协作与AI Agent工作流结合时

전제 조건

前置条件

bash

undefined

bash

undefined

Node.js 18+ 필요

需要Node.js 18+版本

node --version

에이전트 인증 미리 완료

需提前完成Agent认证

claude --version # ANTHROPIC_API_KEY 설정 codex --version # OPENAI_API_KEY 설정 (선택) gemini --version # GOOGLE_API_KEY 설정 (선택) opencode --version # 별도 설정 없음 (GUI 기반)


> **검증된 버전 (2026-02-22 기준)**
> - vibe-kanban: v0.1.17
> - claude (Claude Code): 2.1.50
> - codex: 0.104.0
> - gemini: 0.29.5
> - opencode: 1.2.10

---

claude --version # 需配置ANTHROPIC_API_KEY codex --version # 需配置OPENAI_API_KEY（可选） gemini --version # 需配置GOOGLE_API_KEY（可选） opencode --version # 无需额外配置（基于GUI认证）


> **已验证版本（截至2026-02-22）**
> - vibe-kanban: v0.1.17
> - claude (Claude Code): 2.1.50
> - codex: 0.104.0
> - gemini: 0.29.5
> - opencode: 1.2.10

---

설치 & 실행

安装 & 运行

npx (가장 빠름)

npx方式（最快）

bash

undefined

bash

undefined

즉시 실행 (설치 불필요)

直接运行（无需安装）

npx vibe-kanban

포트 지정 (기본 포트 3000)

指定端口（默认端口3000）

npx vibe-kanban --port 3001

포트와 환경 변수 동시 지정

同时指定端口和环境变量

PORT=3001 npx vibe-kanban --port 3001

래퍼 스크립트 사용

使用包装脚本

bash scripts/vibe-kanban-start.sh


브라우저에서 `http://localhost:3000` 자동 오픈.

> ⚠️ **포트 충돌 주의**: Next.js 등 다른 개발 서버가 3000 포트를 사용 중이라면
> `PORT=3001 npx vibe-kanban --port 3001`로 실행하세요.
> 시작 로그에서 `Main server on :3001` 확인 후 `http://localhost:3001` 접속.

시작 시 정상 로그:

Starting vibe-kanban v0.1.17... No user profiles.json found, using defaults only Starting PR monitoring service with interval 60s Remote client initialized with URL: https://api.vibekanban.com Main server on :3001, Preview proxy on :XXXXX Opening browser...

undefined

bash scripts/vibe-kanban-start.sh


浏览器会自动打开`http://localhost:3000`。

> ⚠️ **注意端口冲突**：若Next.js等其他开发服务器占用3000端口，请执行
> `PORT=3001 npx vibe-kanban --port 3001`启动。
> 启动日志中出现`Main server on :3001`后，访问`http://localhost:3001`。

正常启动日志：

undefined

직접 클론 + 개발 모드

克隆仓库 + 开发模式

bash

git clone https://github.com/BloopAI/vibe-kanban.git
cd vibe-kanban
pnpm i
pnpm run dev

bash

git clone https://github.com/BloopAI/vibe-kanban.git
cd vibe-kanban
pnpm i
pnpm run dev

환경 변수

环境变量

변수	설명	기본값
`PORT`	서버 포트	`3000`
`HOST`	서버 호스트	`127.0.0.1`
`VIBE_KANBAN_REMOTE`	원격 연결 허용	`false`
`VK_ALLOWED_ORIGINS`	CORS 허용 출처	미설정
`DISABLE_WORKTREE_CLEANUP`	worktree 정리 비활성화	미설정
`ANTHROPIC_API_KEY`	Claude Code 에이전트용	—
`OPENAI_API_KEY`	Codex/GPT 에이전트용	—
`GOOGLE_API_KEY`	Gemini 에이전트용	—

.env

파일에 설정 후 서버 시작.

에이전트별 API 키 설정 위치 (Settings → Agents → Environment variables)
Claude Code:
ANTHROPIC_API_KEY
Codex:
OPENAI_API_KEY
Gemini:
GOOGLE_API_KEY
Opencode: 별도 설정 없음 (내장 인증)

变量	说明	默认值
`PORT`	服务器端口	`3000`
`HOST`	服务器主机	`127.0.0.1`
`VIBE_KANBAN_REMOTE`	允许远程连接	`false`
`VK_ALLOWED_ORIGINS`	CORS允许来源	未设置
`DISABLE_WORKTREE_CLEANUP`	禁用worktree清理	未设置
`ANTHROPIC_API_KEY`	用于Claude Code Agent	—
`OPENAI_API_KEY`	用于Codex/GPT Agent	—
`GOOGLE_API_KEY`	用于Gemini Agent	—

在

.env

文件中配置后启动服务器。

各Agent的API密钥配置位置（Settings → Agents → Environment variables）
Claude Code:
ANTHROPIC_API_KEY
Codex:
OPENAI_API_KEY
Gemini:
GOOGLE_API_KEY
Opencode: 无需额外配置（内置认证）

MCP 설정

MCP配置

Vibe Kanban은 MCP(Model Context Protocol) 서버로 동작하여 에이전트가 직접 보드를 제어할 수 있습니다.

Vibe Kanban可作为MCP（Model Context Protocol）服务器运行，允许Agent直接控制看板。

Claude Code MCP 설정

Claude Code MCP配置

~/.claude/settings.json

또는 프로젝트의

.mcp.json

json

{
  "mcpServers": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["vibe-kanban", "--mcp"],
      "env": {
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "3001"
      }
    }
  }
}

在

~/.claude/settings.json

或项目的

.mcp.json

中配置：

json

{
  "mcpServers": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["vibe-kanban", "--mcp"],
      "env": {
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "3001"
      }
    }
  }
}

OpenCode MCP 설정

OpenCode MCP配置

~/.config/opencode/opencode.json

에 추가:

json

{
  "mcp": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["vibe-kanban", "--mcp"],
      "env": {
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "3001"
      }
    }
  }
}

재시작 후

vk_*

도구가 OpenCode 세션에서 바로 사용 가능합니다.

在

~/.config/opencode/opencode.json

中添加：

json

{
  "mcp": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["vibe-kanban", "--mcp"],
      "env": {
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "3001"
      }
    }
  }
}

重启后，

vk_*

工具可直接在OpenCode会话中使用。

MCP 도구 목록

MCP工具列表

도구	설명
`vk_list_cards`	모든 카드(워크스페이스) 조회
`vk_create_card`	새 카드 생성
`vk_move_card`	카드 상태 변경
`vk_get_diff`	카드 diff 조회
`vk_retry_card`	카드 재실행

⚠️ 이전 버전 도구명과 변경:
vk_list_tasks
→
vk_list_cards
,
vk_create_task
→
vk_create_card
v0.1.17 기준 실제 MCP API에서 확인된 도구명입니다.

工具	说明
`vk_list_cards`	查看所有卡片（工作区）
`vk_create_card`	创建新卡片
`vk_move_card`	更改卡片状态
`vk_get_diff`	查看卡片diff
`vk_retry_card`	重新执行卡片任务

⚠️ 注意工具名称变更：
vk_list_tasks
→
vk_list_cards
，
vk_create_task
→
vk_create_card
以上为v0.1.17版本中实际MCP API的工具名称。

Codex MCP 적용

Codex MCP适配

Codex에서 Vibe Kanban을 연동하려면 프로젝트 루트에서 다음을 실행합니다.

bash

bash scripts/mcp-setup.sh --codex

이 명령은

~/.codex/config.toml

에

vibe-kanban

MCP 서버 설정을 추가합니다.
훅 기반 자동 반복은 Codex 기본 동작이 아니므로, 재시도/반복 운영은 보드 카드 진행 상태 또는 상위 오케스트레이션으로 관리합니다.

若要在Codex中联动Vibe Kanban，在项目根目录执行：

bash

bash scripts/mcp-setup.sh --codex

此命令会在

~/.codex/config.toml

中添加

vibe-kanban

MCP服务器配置。基于钩子的自动重试并非Codex默认功能，需通过看板卡片状态或上层编排来管理重试/重复执行。

워크스페이스 → 병렬 에이전트 → PR 워크플로우

工作区 → 并行Agent → PR工作流

v0.1.17 실제 UI 구조: Vibe Kanban은 Kanban 보드 형태이지만, 실제 작업 단위는 Workspace (워크스페이스)입니다. 각 워크스페이스가 하나의 태스크를 독립적으로 처리합니다.

v0.1.17版本实际UI结构：Vibe Kanban虽为Kanban看板形式，但实际工作单元为Workspace（工作区）。每个工作区独立处理一个任务。

1. 서버 시작

1. 启动服务器

bash

undefined

bash

undefined

기본 실행

默认运行

npx vibe-kanban

→ http://localhost:3000

포트 충돌 시 (Next.js 등)

端口冲突时（如Next.js占用3000）

PORT=3001 npx vibe-kanban --port 3001

→ http://localhost:3001

undefined

undefined

2. (선택) planno로 에픽 계획 검토

2. （可选）使用planno审核史诗需求规划

text

planno로 이 기능의 구현 계획을 검토해줘

planno(plannotator)는 독립 스킬 — Vibe Kanban 없이도 사용 가능.

text

请用planno审核此功能的实现规划

planno（plannotator）是独立技能 — 无需Vibe Kanban即可使用。

3. 워크스페이스 생성 (Create Workspace)

3. 创建工作区（Create Workspace）

UI 접속 → "+ Create Workspace" 또는 왼쪽 사이드바
```
+
```
버튼 클릭
Which repositories? 화면:
- Browse → 파일 시스템에서 git 레포 선택 (경로 수동 입력 가능)
- Recent → 이전에 사용한 레포
- 레포 선택 후 브랜치 선택 (기본:
```
main
```
  )
- Continue 클릭
What would you like to work on? 화면:
- 에이전트 선택 (Opencode, Claude Code, Codex, Gemini, Amp, Qwen Code, Copilot, Droid, Cursor Agent)
- 태스크 설명 입력 (Markdown 지원)
- 모드 선택 (Default, Build 등)
- Create 클릭

访问UI → 点击**"+ Create Workspace"**或左侧侧边栏
```
+
```
按钮
**Which repositories?**界面：
- Browse → 从文件系统中选择git仓库（可手动输入路径）
- Recent → 选择之前使用过的仓库
- 选择仓库后选择分支（默认：
```
main
```
  ）
- 点击Continue
**What would you like to work on?**界面：
- 选择Agent（Opencode、Claude Code、Codex、Gemini、Amp、Qwen Code、Copilot、Droid、Cursor Agent）
- 输入任务描述（支持Markdown）
- 选择模式（Default、Build等）
- 点击Create

4. 에이전트 자동 실행

4. Agent自动执行

워크스페이스 생성 시:

vk/<hash>-<slug>

브랜치 자동 생성 (예:

vk/3816-add-a-comment-to

)

git worktree 자동 생성 (에이전트별 완전 격리)
선택한 에이전트 CLI 실행 + 로그 스트리밍

워크스페이스 상태:

Running: 에이전트 실행 중 (왼쪽 사이드바)
Idle: 대기 중
Needs Attention: 에이전트 완료 또는 입력 필요

创建工作区时：

自动创建

vk/<hash>-<slug>

分支（例如：

vk/3816-add-a-comment-to

）

自动创建git worktree（实现Agent间完全隔离）
执行所选Agent CLI并流式输出日志

工作区状态：

Running：Agent执行中（左侧侧边栏显示）
Idle：等待中
Needs Attention：Agent执行完成或需要输入

5. 결과 확인

5. 查看结果

Changes 패널: 파일 diff 확인
Logs 패널: 에이전트 실행 로그
Preview 패널: 웹앱 미리보기
Terminal: 직접 명령 실행
Notes: 메모 작성

Changes面板：查看文件diff
Logs面板：查看Agent执行日志
Preview面板：预览Web应用
Terminal：直接执行命令
Notes：添加备注

6. PR 생성 & 완료

6. 创建PR & 完成任务

워크스페이스 상세 → "Open pull request" 버튼
PR merge → 워크스페이스 Archive로 이동
worktree 자동 정리

进入工作区详情 → 点击**"Open pull request"**按钮
PR合并后 → 工作区移至Archive
自动清理worktree

Git Worktree 격리 구조

Git Worktree隔离结构

워크스페이스 디렉토리 (Settings → General → Workspace Directory에서 변경 가능):

~/.vibe-kanban-workspaces/          ← 기본 위치 (홈 디렉토리 하위)
├── <workspace-uuid-1>/             ← 워크스페이스1 격리 환경
├── <workspace-uuid-2>/             ← 워크스페이스2 격리 환경
└── <workspace-uuid-3>/             ← 워크스페이스3 격리 환경

브랜치 네이밍 (Settings → General → Git → Branch Prefix에서 변경):

vk/<4자 ID>-<task-slug>
예: vk/3816-add-a-comment-to-readme

내부 동작:

bash

git worktree add <workspace-dir> -b vk/<hash>-<task-slug> main
<agent-cli> -p "<task-description>" --cwd <workspace-dir>

.gitignore 권장 항목 추가:
.vibe-kanban-workspaces/
.vibe-kanban/

工作区目录（可在Settings → General → Workspace Directory中修改）：

~/.vibe-kanban-workspaces/          ← 默认位置（主目录下）
├── <workspace-uuid-1>/             ← 工作区1隔离环境
├── <workspace-uuid-2>/             ← 工作区2隔离环境
└── <workspace-uuid-3>/             ← 工作区3隔离环境

分支命名规则（可在Settings → General → Git → Branch Prefix中修改）：

vk/<4位ID>-<task-slug>
示例：vk/3816-add-a-comment-to-readme

内部执行逻辑：

bash

git worktree add <workspace-dir> -b vk/<hash>-<task-slug> main
<agent-cli> -p "<task-description>" --cwd <workspace-dir>

推荐添加到.gitignore的条目：
.vibe-kanban-workspaces/
.vibe-kanban/

원격 배포

远程部署

Docker

bash

undefined

bash

undefined

공식 이미지

官方镜像

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
vibekanban/vibe-kanban

undefined

docker run -p 3000:3000
-e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY
-e VK_ALLOWED_ORIGINS=https://vk.example.com
vibekanban/vibe-kanban

undefined

리버스 프록시 (Nginx/Caddy)

反向代理（Nginx/Caddy）

bash

undefined

bash

undefined

CORS 허용 필수

必须配置CORS允许

VK_ALLOWED_ORIGINS=https://vk.example.com

또는 다중 출처

或多个允许来源

VK_ALLOWED_ORIGINS=https://a.example.com,https://b.example.com

undefined

VK_ALLOWED_ORIGINS=https://a.example.com,https://b.example.com

undefined

SSH 원격 열기

SSH远程打开

VSCode Remote-SSH와 통합:

vscode://vscode-remote/ssh-remote+user@host/path/to/.vk/trees/<task-slug>

与VSCode Remote-SSH集成：

vscode://vscode-remote/ssh-remote+user@host/path/to/.vk/trees/<task-slug>

트러블슈팅

故障排除

Worktree 충돌 / 고아 worktree

Worktree冲突 / 孤立worktree

bash

undefined

bash

undefined

고아 worktree 정리

清理孤立worktree

git worktree prune

현재 worktree 목록 확인

查看当前worktree列表

git worktree list

특정 worktree 강제 삭제

强制删除特定worktree

git worktree remove .vk/trees/<slug> --force

undefined

git worktree remove .vk/trees/<slug> --force

undefined

403 Forbidden (CORS 오류)

403 Forbidden（CORS错误）

bash

undefined

bash

undefined

원격 접속 시 CORS 설정 필요

远程访问时需配置CORS

VK_ALLOWED_ORIGINS=https://your-domain.com npx vibe-kanban

undefined

VK_ALLOWED_ORIGINS=https://your-domain.com npx vibe-kanban

undefined

에이전트가 시작되지 않음

Agent无法启动

bash

undefined

bash

undefined

CLI 직접 테스트

直接测试CLI

claude --version codex --version

API 키 확인

检查API密钥

echo $ANTHROPIC_API_KEY echo $OPENAI_API_KEY

undefined

echo $ANTHROPIC_API_KEY echo $OPENAI_API_KEY

undefined

포트 충돌

端口冲突

bash

undefined

bash

undefined

다른 포트 사용

使用其他端口

npx vibe-kanban --port 3001

또는 환경 변수

或通过环境变量

PORT=3001 npx vibe-kanban

undefined

PORT=3001 npx vibe-kanban

undefined

SQLite 락 오류

SQLite锁错误

bash

undefined

bash

undefined

worktree 정리 비활성화 후 재시작

禁用worktree清理后重启

DISABLE_WORKTREE_CLEANUP=1 npx vibe-kanban

---

DISABLE_WORKTREE_CLEANUP=1 npx vibe-kanban

---

UI vs CLI 선택 기준

UI vs CLI选择标准

상황	모드
팀 공유 보드, 시각적 진행 추적	UI ( `npx vibe-kanban` )
CI/CD 파이프라인, 스크립트 자동화	CLI ( `scripts/pipeline.sh` )
빠른 로컬 실험	CLI ( `scripts/conductor.sh` )
브라우저 diff/로그 리뷰	UI

场景	模式
团队共享看板、可视化进度追踪	UI（ `npx vibe-kanban` ）
CI/CD流水线、脚本自动化	CLI（ `scripts/pipeline.sh` ）
快速本地实验	CLI（ `scripts/conductor.sh` ）
浏览器中查看diff/日志	UI

지원 에이전트 목록 (v0.1.17 검증)

支持的Agent列表（v0.1.17已验证）

Settings → Agents에서 각 에이전트별 상세 설정 가능:

에이전트	명령	API 키
Opencode	`opencode`	내장 (기본값)
Claude Code	`claude`	`ANTHROPIC_API_KEY`
Codex	`codex`	`OPENAI_API_KEY`
Gemini	`gemini`	`GOOGLE_API_KEY`
Amp	`amp`	별도
Qwen Code	`qwen-coder`	별도
Copilot	`copilot`	GitHub 계정
Droid	`droid`	별도
Cursor Agent	`cursor`	Cursor 구독

에이전트별 설정 가능 항목:

Append prompt: 에이전트 실행 시 추가 지시문
Model: 사용할 모델명 (예:
```
claude-opus-4-6
```
)
Variant: 모델 변형
Auto Approve: 에이전트 액션 자동 승인 (기본: ON)
Auto Compact: 컨텍스트 자동 압축 (기본: ON)
Environment variables: API 키 등 환경변수

在Settings → Agents中可配置各Agent的详细设置：

Agent	命令	API密钥
Opencode	`opencode`	内置（默认）
Claude Code	`claude`	`ANTHROPIC_API_KEY`
Codex	`codex`	`OPENAI_API_KEY`
Gemini	`gemini`	`GOOGLE_API_KEY`
Amp	`amp`	单独配置
Qwen Code	`qwen-coder`	单独配置
Copilot	`copilot`	GitHub账号
Droid	`droid`	单独配置
Cursor Agent	`cursor`	Cursor订阅

各Agent可配置的项：

Append prompt：Agent执行时添加的额外指令
Model：使用的模型名称（例如：
```
claude-opus-4-6
```
）
Variant：模型变体
Auto Approve：自动批准Agent操作（默认：开启）
Auto Compact：自动压缩上下文（默认：开启）
Environment variables：API密钥等环境变量

대표 사용 케이스

典型使用场景

1. 에픽 병렬 분해 처리

1. 史诗需求并行拆解处理

"결제 플로우 v2" 에픽
  ├── 워크스페이스1: 프론트엔드 UI  → Claude Code
  ├── 워크스페이스2: 백엔드 API     → Codex
  └── 워크스페이스3: 통합 테스트    → Opencode
→ 3개 워크스페이스 동시 Running → 병렬 구현

"支付流程v2"史诗需求
  ├── 工作区1：前端UI  → Claude Code
  ├── 工作区2：后端API     → Codex
  └── 工作区3：集成测试    → Opencode
→ 3个工作区同时Running → 并行实现

2. 역할별 전문 에이전트 배치

2. 按角色分配专业Agent

Claude Code  → 설계/도메인 heavy 기능
Codex        → 타입/테스트/리팩터링
Gemini       → 문서/스토리북 작성
Opencode     → 범용 작업 (기본값)

Claude Code  → 侧重设计/领域相关功能
Codex        → 侧重类型/测试/重构
Gemini       → 侧重文档/Storybook编写
Opencode     → 通用任务（默认）

3. GitHub PR 기반 팀 협업

3. 基于GitHub PR的团队协作

VIBE_KANBAN_REMOTE=true 설정
→ 팀원이 보드에서 상태 확인
→ GitHub PR에서만 리뷰/승인
→ 에이전트 병렬 + 전통 PR 프로세스 결합

设置VIBE_KANBAN_REMOTE=true
→ 团队成员可在看板中查看状态
→ 仅在GitHub PR中进行审核/批准
→ 结合Agent并行执行与传统PR流程

4. 구현 비교

4. 实现方案对比

동일 태스크, 두 개 워크스페이스:
  워크스페이스A → Claude Code (UI 구조 중심)
  워크스페이스B → Codex (성능 최적화 중심)
→ PR 비교 후 best-of-both 선택

同一任务，创建两个工作区：
  工作区A → Claude Code（侧重UI结构）
  工作区B → Codex（侧重性能优化）
→ 对比PR后选择最优方案

5. OpenCode + ulw 병렬 위임

5. OpenCode + ulw并行委托

OpenCode의 ulw(ultrawork) 모드와 결합해 에이전트를 에픽 단위로 병렬 실행:

python

undefined

结合OpenCode的ulw(ultrawork)模式，按史诗需求级别并行执行Agent：

python

undefined

ulw 키워드 → ultrawork 병렬 실행 레이어 활성화

ulw关键字 → 启用ultrawork并行执行层

Vibe Kanban 보드: npx vibe-kanban (별도 터미널에서 실행)

Vibe Kanban看板：在单独终端执行npx vibe-kanban

task(category="visual-engineering", run_in_background=True, load_skills=["frontend-ui-ux", "vibe-kanban"], description="[Kanban WS1] 프론트엔드 UI", prompt="결제 플로우 UI 구현 — src/components/payment/ 내 카드 입력, 주문 확인, 완료 화면")

task(category="unspecified-high", run_in_background=True, load_skills=["vibe-kanban"], description="[Kanban WS2] 백엔드 API", prompt="결제 플로우 API 구현 — POST /charge, POST /refund, GET /status/:id")

task(category="unspecified-low", run_in_background=True, load_skills=["vibe-kanban"], description="[Kanban WS3] 통합 테스트", prompt="결제 E2E 테스트 작성 — 성공/실패/환불 시나리오")

task(category="visual-engineering", run_in_background=True, load_skills=["frontend-ui-ux", "vibe-kanban"], description="[Kanban WS1] 前端UI", prompt="实现支付流程UI — src/components/payment/ 下的卡片输入、订单确认、完成页面")

task(category="unspecified-high", run_in_background=True, load_skills=["vibe-kanban"], description="[Kanban WS2] 后端API", prompt="实现支付流程API — POST /charge, POST /refund, GET /status/:id")

task(category="unspecified-low", run_in_background=True, load_skills=["vibe-kanban"], description="[Kanban WS3] 集成测试", prompt="编写支付E2E测试 — 成功/失败/退款场景")

→ 3개 워크스페이스가 Running 상태로 Kanban 보드에 동시 표시

→ 3个工作区将以Running状态同时显示在Kanban看板中

→ 각 완료 시: Needs Attention → PR 생성 → Archive

→ 完成时：Needs Attention → 创建PR → Archive

---

---

팁

小贴士

카드 범위를 좁게 유지 (1카드 = 1커밋 단위)
2개 파일 이상 변경 시 planno로 먼저 계획 검토
```
VIBE_KANBAN_REMOTE=true
```
는 신뢰 네트워크에서만 사용
에이전트 스탈 시 → 재할당 또는 카드 분할

保持卡片范围狭窄（1卡片 = 1提交单元）
若需修改2个以上文件，先使用planno审核规划
```
VIBE_KANBAN_REMOTE=true
```
仅在可信网络中使用
若Agent停滞，可重新分配或拆分卡片

아키텍처 개요

架构概述

┌─────────────────────────────────────────────────────────┐
│                    Vibe Kanban UI                       │
│   ┌──────────┬──────────┬──────────┬──────────┐        │
│   │  To Do   │In Progress│  Review  │   Done   │        │
│   └──────────┴──────────┴──────────┴──────────┘        │
└───────────────────────────┬─────────────────────────────┘
                            │ REST API
┌───────────────────────────▼─────────────────────────────┐
│                    Rust Backend                         │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌──────────┐  │
│  │ server  │  │executors │  │   git   │  │ services │  │
│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
│                   │                                     │
│             ┌─────▼─────┐                               │
│             │  SQLite   │                               │
│             └───────────┘                               │
└─────────────────────────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        │                   │                   │
   ┌────▼────┐        ┌─────▼─────┐       ┌────▼────┐
   │ Claude  │        │   Codex   │       │ Gemini  │
   │worktree1│        │ worktree2 │       │worktree3│
   └─────────┘        └───────────┘       └─────────┘

┌─────────────────────────────────────────────────────────┐
│                    Vibe Kanban UI                       │
│   ┌──────────┬──────────┬──────────┬──────────┐        │
│   │  To Do   │In Progress│  Review  │   Done   │        │
│   └──────────┴──────────┴──────────┴──────────┘        │
└───────────────────────────┬─────────────────────────────┘
                            │ REST API
┌───────────────────────────▼─────────────────────────────┐
│                    Rust Backend                         │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌──────────┐  │
│  │ server  │  │executors │  │   git   │  │ services │  │
│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
│                   │                                     │
│             ┌─────▼─────┐                               │
│             │  SQLite   │                               │
│             └───────────┘                               │
└─────────────────────────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        │                   │                   │
   ┌────▼────┐        ┌─────▼─────┐       ┌────▼────┐
   │ Claude  │        │   Codex   │       │ Gemini  │
   │worktree1│        │ worktree2 │       │worktree3│
   └─────────┘        └───────────┘       └─────────┘

참고 레퍼런스

参考资源

스킬 파일 구조

技能文件结构

.agent-skills/vibe-kanban/
├── SKILL.md              # 메인 스킬 문서
├── SKILL.toon            # TOON 형식 (압축)
├── scripts/
│   ├── start.sh          # 서버 시작 래퍼
│   ├── cleanup.sh        # Worktree 정리
│   ├── mcp-setup.sh      # MCP 설정 자동화
│   └── health-check.sh   # 서버 상태 확인
├── references/
│   ├── environment-variables.md  # 환경 변수 레퍼런스
│   └── mcp-api.md                # MCP API 레퍼런스
└── templates/
    ├── claude-mcp-config.json    # Claude Code MCP 설정
    ├── docker-compose.yml        # Docker 배포 템플릿
    └── .env.example              # 환경 변수 예시

.agent-skills/vibe-kanban/
├── SKILL.md              # 主技能文档
├── SKILL.toon            # TOON格式（压缩）
├── scripts/
│   ├── start.sh          # 服务器启动包装脚本
│   ├── cleanup.sh        # Worktree清理脚本
│   ├── mcp-setup.sh      # MCP配置自动化脚本
│   └── health-check.sh   # 服务器状态检查脚本
├── references/
│   ├── environment-variables.md  # 环境变量参考
│   └── mcp-api.md                # MCP API参考
└── templates/
    ├── claude-mcp-config.json    # Claude Code MCP配置模板
    ├── docker-compose.yml        # Docker部署模板
    └── .env.example              # 环境变量示例

스크립트 사용법

脚本使用方法

bash

undefined

bash

undefined

서버 시작

启动服务器

bash scripts/start.sh --port 3001

Worktree 정리

清理Worktree

bash scripts/cleanup.sh --dry-run # 미리보기 bash scripts/cleanup.sh --all # 모든 VK worktree 삭제

bash scripts/cleanup.sh --dry-run # 预览清理内容 bash scripts/cleanup.sh --all # 删除所有VK worktree

MCP 설정

配置MCP

bash scripts/mcp-setup.sh --claude # Claude Code 설정 bash scripts/mcp-setup.sh --all # 모든 에이전트 설정

bash scripts/mcp-setup.sh --claude # 配置Claude Code bash scripts/mcp-setup.sh --all # 配置所有Agent

상태 확인

检查状态

bash scripts/health-check.sh bash scripts/health-check.sh --json # JSON 출력

---

bash scripts/health-check.sh bash scripts/health-check.sh --json # 以JSON格式输出

---

Quick Reference

快速参考

=== 서버 실행 ===
npx vibe-kanban                       즉시 실행 (포트 3000)
PORT=3001 npx vibe-kanban --port 3001 포트 충돌 시 (Next.js 등)
http://localhost:3000                  보드 UI

=== 환경 변수 ===
PORT=3001                        포트 변경
VK_ALLOWED_ORIGINS=https://...   CORS 허용
ANTHROPIC_API_KEY=...            Claude Code 인증
OPENAI_API_KEY=...               Codex 인증
GOOGLE_API_KEY=...               Gemini 인증

=== MCP 연동 ===
npx vibe-kanban --mcp            MCP 모드
vk_list_cards                    카드(워크스페이스) 조회
vk_create_card                   카드 생성
vk_move_card                     상태 변경

=== 워크스페이스 흐름 ===
Create → Running → Needs Attention → Archive
Running: worktree 생성 + 에이전트 시작
Needs Attention: 완료 또는 입력 필요
Archive: PR merge 완료

=== MCP 설정 파일 위치 ===
Opencode: ~/.config/opencode/opencode.json
Claude Code: ~/.claude/settings.json 또는 .mcp.json

=== worktree 정리 ===
git worktree prune               고아 정리
git worktree list                목록 확인
git worktree remove <path>       강제 삭제

=== 服务器运行 ===
npx vibe-kanban                       直接运行（端口3000）
PORT=3001 npx vibe-kanban --port 3001 端口冲突时使用（如Next.js占用3000）
http://localhost:3000                  看板UI地址

=== 环境变量 ===
PORT=3001                        修改端口
VK_ALLOWED_ORIGINS=https://...   配置CORS允许来源
ANTHROPIC_API_KEY=...            Claude Code认证密钥
OPENAI_API_KEY=...               Codex认证密钥
GOOGLE_API_KEY=...               Gemini认证密钥

=== MCP联动 ===
npx vibe-kanban --mcp            启动MCP模式
vk_list_cards                    查看卡片（工作区）
vk_create_card                   创建卡片
vk_move_card                     更改卡片状态

=== 工作区流程 ===
Create → Running → Needs Attention → Archive
Running: 创建worktree + 启动Agent
Needs Attention: 执行完成或需要输入
Archive: PR合并完成

=== MCP配置文件位置 ===
Opencode: ~/.config/opencode/opencode.json
Claude Code: ~/.claude/settings.json 或 .mcp.json

=== worktree清理 ===
git worktree prune               清理孤立worktree
git worktree list                查看worktree列表
git worktree remove <path>       强制删除worktree