MVP Kanban Board Skill - v0.0.1

# MVP Kanban Board Skill - v0.0.1

📖 描述

MVP 看板系统 - 完整的任务管理技能，包含 Docker 镜像和完整源代码。

支持任务管理、泳道管理、批量操作、AI 分析和向量搜索。

通过 MCP 协议提供 21 个工具，支持 Web 界面、REST API 和 MCP 工具调用。

✨ 功能特性

🚀 快速开始

方式 1: 从 ClawHub 安装（推荐）

clawhub install mvp-kanban

方式 2: 本地安装

# 1. 复制 Skill 到 OpenClaw
cp -r mvp-kanban-complete-skill ~/.openclaw/workspace/skills/mvp-kanban

# 2. 进入目录
cd ~/.openclaw/workspace/skills/mvp-kanban

# 3. 构建 Docker 镜像
docker build -t mvp-kanban:latest docker/

# 4. 启动服务
docker-compose up -d

# 5. 访问 Web 界面
# http://localhost:9999

方式 3: 使用预构建镜像

# 拉取 Docker 镜像
docker pull your-dockerhub-username/mvp-kanban:latest

# 运行
docker run -d -p 9999:5000 -v kanban-data:/app/data mvp-kanban:latest

📁 包结构

mvp-kanban-complete-skill/
├── SKILL.md                    # 本文件
├── clawhub.yaml                # ClawHub 配置
├── mcp.json                    # MCP 配置
├── README.md                   # 快速开始
├── docker/                     # Docker 镜像部分
│   ├── Dockerfile
│   ├── docker-compose.yml
│   ├── .dockerignore
│   ├── app.py                  # Flask 应用
│   ├── database.py             # 数据库模块
│   ├── mcp_server.py           # MCP Server
│   ├── nlp_parser.py           # NLP 解析器
│   └── templates/              # Web 界面
├── src/                        # 完整源代码
│   ├── app.py
│   ├── database.py
│   ├── mcp_server.py
│   ├── mcp_client.py
│   ├── nlp_parser.py
│   └── templates/
└── docs/                       # 完整文档
    ├── API.md
    ├── WEB_UI_GUIDE.md
    ├── USAGE_METHODS.md
    ├── QUICK_TEST.md
    └── ...

🛠️ MCP 工具（21 个）

任务管理（7 个）

1. `list_projects` - 列出所有项目

2. `get_project_details` - 获取项目详情

3. `add_project` - 添加项目

4. `update_project_status` - 更新状态

5. `update_project_full` - 完整更新

6. `move_project` - 移动项目

7. `delete_project` - 删除项目

泳道管理（5 个）

8. `list_lanes` - 列出泳道

9. `add_lane` - 添加泳道

10. `update_lane` - 更新泳道

11. `delete_lane` - 删除泳道

12. `get_lane_details` - 泳道详情

批量操作（3 个）

13. `batch_create_projects` - 批量创建

14. `batch_update_projects` - 批量更新

15. `batch_delete_projects` - 批量删除

AI 功能（4 个）

16. `analyze_board` - AI 看板分析

17. `search_similar_projects` - 向量搜索

18. `nlp_command` - 自然语言命令

19. `llm_search` - 向量搜索

辅助功能（2 个）

20. `get_board_metrics` - 获取统计指标

21. `get_project_history` - 变更历史

⚙️ 配置

MCP 配置

安装后自动配置 `~/.openclaw/config/mcp.json`：

{
  "mcpServers": {
    "kanban": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mvp-kanban:latest",
        "python",
        "mcp_server.py"
      ],
      "cwd": "/root/.openclaw/workspace/skills/mvp-kanban/docker",
      "env": {
        "PYTHONPATH": "/app"
      }
    }
  }
}

Docker Compose

version: 0.0.1

services:
  kanban:
    image: mvp-kanban:latest
    container_name: mvp-kanban
    ports:
      - "9999:5000"
    volumes:
      - kanban-data:/app/data
    environment:
      - FLASK_ENV=production
    restart: unless-stopped

📖 使用方式

Web 界面

访问 **http://localhost:9999**

REST API

# 添加任务
curl -X POST http://localhost:9999/api/projects \
  -H "Content-Type: application/json" \
  -d '{"name":"任务","lane":"feature","priority":"high"}'

# 更新任务
curl -X PUT http://localhost:9999/api/projects/1 \
  -H "Content-Type: application/json" \
  -d '{"status":"in_progress"}'

# AI 分析
curl http://localhost:9999/api/llm/analyze

MCP 工具

from mcp import Client

client = Client("kanban")

# 添加任务
await client.call_tool("add_project", {
    "name": "安全加固",
    "lane": "security",
    "priority": "high"
})

# AI 分析
analysis = await client.call_tool("analyze_board")

自然语言

curl -X POST http://localhost:9999/api/llm/command \
  -H "Content-Type: application/json" \
  -d '{"command":"添加一个高优先级安全任务给张三"}'

📊 系统要求

🏷️ 泳道

默认泳道：

支持自定义泳道！

🎯 使用场景

| 场景 | 推荐方式 |

|------|----------|

| 日常管理 | Web 界面 |

| 开发集成 | REST API |

| AI 自动化 | MCP 工具 |

| 批量导入 | REST API 批量接口 |

| 快速记录 | 自然语言命令 |

📝 示例

CI/CD 集成

# GitHub Actions 发现 bug 自动创建任务
import requests

requests.post("http://localhost:9999/api/projects", json={
    "name": f"修复：{bug_title}",
    "lane": "bugfix",
    "priority": "high",
    "assignee": "developer"
})

AI 助手

# AI 理解后自动调用 MCP
command = "添加一个高优先级的安全任务给张三"
await client.call_tool("nlp_command", {"command": command})

🔧 开发

本地开发模式

cd ~/.openclaw/workspace/skills/mvp-kanban/src

# 安装依赖
pip install -r requirements.txt

# 运行开发服务器
python app.py

构建 Docker 镜像

cd ~/.openclaw/workspace/skills/mvp-kanban/docker

# 构建
docker build -t mvp-kanban:latest .

# 测试
docker run -p 9999:5000 mvp-kanban:latest

🔄 版本

👥 作者

DevSecOps Team

📄 许可证

MIT License

🐛 问题反馈

提交 Issue 到：https://github.com/your-username/mvp-kanban/issues

🎉 贡献

欢迎提交 Pull Request！

📖 更多文档

---

**访问 http://localhost:9999 开始使用！**