VibeKankan🚦🤖
让您的代理驱动编码更加清晰！
欢迎来到VibeKanaban——一个简单、现代的看板，不仅适合你，也适合你的人工智能代理！
✨ 跟踪你的工作。给你的代理人背景。看看每一步都发生了什么。
______________________________________________________________________
为什么选择VibeKankan？ 🤔
你有没有想过，当你要求你的代理修复一个bug或构建一个功能时，它实际上在做什么？VibeKanaban弥合了人工工作流程和代理自动化之间的差距：
- 📝 视觉看板 --使用干净的拖放界面组织您的项目和工单。
- 🤖 代理集成（MCP服务器） --让你的AI代理像真正的队友一样创建、更新和跟踪门票。
- 📊 度量与洞察 --跟踪部署率、错误频率等，以了解您（和您的代理）的运行情况。
- ⚡ 即时设置 --一个剧本，你就可以开始了！
______________________________________________________________________
特性
- 项目管理：创建、查看、编辑和删除项目
- 票务管理：创建和管理带有类型（bug、故事、任务、尖峰）和优先级（低、中、高、关键）的工单
- 看板视图：具有拖放功能的视觉板
- MCP集成：与Cursor集成，用于自动创建和更新工单
- DORA指标：跟踪开发绩效指标
技术栈
- 后端：Python与Flask
- 前端：HTML、JavaScript和顺风CSS
- 数据库：SQLite（本地）
快速设置（推荐）
- 克隆存储库：
git clone https://github.com/shahriarb/vibekanban.git
cd vibekanban- 运行安装脚本：
./setup.sh此脚本将创建虚拟环境、安装依赖项并设置数据库。
- 启动应用程序：
./run.sh- 打开浏览器并导航到：
http://localhost:5050手动设置
如果您更喜欢手动设置或遇到脚本问题：
- 克隆存储库：
git clone https://github.com/shahriarb/vibekanban.git
cd vibekanban- 创建虚拟环境并激活它：
python3 -m venv .venv
source .venv/bin/activate # On Windows, use: .venv\Scripts\activate- 安装依赖项：
pip install -r requirements.txt- 初始化数据库和迁移：
如果这是您第一次设置项目，请运行：
flask db init
flask db migrate -m "Initial migration"
flask db upgrade这将基于当前模型创建数据库表。
如果你已经有了 migrations/ 文件夹，您只需运行：
flask db upgrade- 手动运行应用程序：
python run.pyPython版本兼容性
此应用程序已使用Python 3.13.2进行了测试。如果您使用conda进行Python管理，请确保在您的 .zshrc 文件，但为此应用程序创建一个单独的venv以避免依赖冲突。
光标MCP集成
要与Cursor的MCP集成：
- 确保应用程序正在运行
- 在光标中，转到光标设置>MCP服务器>添加新的全局MCP服务器
在光标MCP设置中：
- 名称：坎班板
- 类型：命令
- 命令：/full/path/to/.venv/bin/python/full/path/to/kanban_mcp_server.py
示例 mcp.json:
{
"mcpServers": {
"KanbanBoard": {
"command": "/full/path/to/.venv/bin/python /full/path/to/kanban_mcp_server.py",
"args": [],
"enabled": true
}
}
}使用KanbanBoard MCP
配置后，您可以使用以下命令：
@KanbanBoard get kanban status-按州查看门票数量@KanbanBoard get project ID by name-按项目名称查找项目ID@KanbanBoard list projects-列出所有项目@KanbanBoard list tickets-列出所有门票@KanbanBoard create ticket-创建具有指定类型和优先级的新票证@KanbanBoard update ticket state-更新票证的状态@KanbanBoard add comment-在工单上添加评论
在Cursor中使用MCP服务器的示例规则
You are an AI assistant specialized in software development design and architecture.
Note: Please use @KanbanBoard MCP to document your work in each step. The project_id is .
That's a crucial part of the process.
For each feature or improvment request:
- Evaluate the request's complexity to determine if it should be a single ticket or broken into multiple tickets.
- Break Down Subtasks: Identify subtasks for frontend, backend, database, and testing and create them in the @KanbanBoard
- Determine Dependencies: Establish any task dependencies upfront and document them in the @KanbanBoard
- Define Acceptance Criteria: Set clear criteria for each task and document in the @KanbanBoard
- Tailor Testing Methods: For each subtask, define appropriate testing methods. For example, backend tasks might include API tests with tools like Postman or CURL, while frontend tasks might require unit tests with frameworks like Jest. Document the Test Steps in the @KanbanBoard.
- Ticket Flexibility: Allow flexibility to adjust the number of tickets based on ongoing discoveries during development.
- Prioritization: After all tasks defined follow these rules to set the priority for each task:
- Assess urgency and impact to prioritize critical bugs and high-impact features.
- Address tasks with dependencies first to unblock other work.
- Prioritize tasks delivering significant business value.
- Balance effort and complexity for practical progress.
Set the priority in the @KanbanBoard
- Development: Follow defined acceptance criteria for each task.
Conduct task-specific testing (unit, integration, end-to-end).
- Ticket Flexibility: Remain flexible to add tasks during development if required.
For each Bug report:
- Create a ticket with the type of 'bug' and add the information I shared with you in the @KanbanBoard. Set clear criteria about what should be fixed and set the priority as high or critical based on the bug's impact.
- Evaluate the reason bug is happening and add findings as the comment to the ticket in the @KanbanBoard.
- Move the ticket to 'in progress' state in the @KanbanBoard and start fixing the bug based on defined criteria.
- Move the ticket to 'done' state in the @KanbanBoard when the bug is fixed.许可证
麻省理工学院