# 添加市场
claude plugins marketplace add KanoCifer/DevTaskMcp

# 安装插件
claude plugins install devtask@devtask

/plugin marketplace add KanoCifer/DevTaskMcp
/plugin install devtask@devtask

claude --plugin-dir /path/to/DevTaskMcp

# 1. 配置 MCP server（添加到 ~/.claude.json 或项目 .mcp.json）
#    带 uv：
#      "command": "uv",
#      "args": ["run", "--directory", "/path/to/DevTaskMcp", "python", "-m", "devtask_mcp.server"]
#    不带 uv：
#      "command": "/path/to/DevTaskMcp/.venv/bin/python",
#      "args": ["-m", "devtask_mcp.server"]

# 2. 链接技能目录
# 作为 user-level 技能（全局可用）
ln -s /path/to/DevTaskMcp/skills/devtask-setup ~/.claude/skills/devtask-setup
ln -s /path/to/DevTaskMcp/skills/devtask-grill ~/.claude/skills/devtask-grill
ln -s /path/to/DevTaskMcp/skills/devtask-plan ~/.claude/skills/devtask-plan
ln -s /path/to/DevTaskMcp/skills/devtask-simple ~/.claude/skills/devtask-simple
ln -s /path/to/DevTaskMcp/skills/devtask-doit ~/.claude/skills/devtask-doit
ln -s /path/to/DevTaskMcp/skills/devtask-review ~/.claude/skills/devtask-review

# 或作为 project-level 技能（放在项目 .claude/skills/ 下）
mkdir -p .claude/skills
ln -s /path/to/DevTaskMcp/skills/devtask-setup .claude/skills/devtask-setup
ln -s /path/to/DevTaskMcp/skills/devtask-grill .claude/skills/devtask-grill
ln -s /path/to/DevTaskMcp/skills/devtask-plan .claude/skills/devtask-plan
ln -s /path/to/DevTaskMcp/skills/devtask-simple .claude/skills/devtask-simple
ln -s /path/to/DevTaskMcp/skills/devtask-doit .claude/skills/devtask-doit
ln -s /path/to/DevTaskMcp/skills/devtask-review .claude/skills/devtask-review

scripts/setup.sh              # 创建 .venv 并安装依赖
# 或指定解释器：
PYTHON=python3.11 scripts/setup.sh

python3 -m venv .venv
.venv/bin/pip install -e .

{
  "mcpServers": {
    "devtask": {
      "command": "/path/to/DevTaskMcp/.venv/bin/python",
      "args": ["-m", "devtask_mcp.server"]
    }
  }
}

cp .env.example .env
# 填写 DEVTASK_API_KEY（必填）和 DEVTASK_API_BASE（可选）

/devtask:devtask-setup                   # 初始化：检查环境 + 写 CLAUDE.md 引导
/devtask:devtask-grill                   # 探讨方案选型与权衡
/devtask:devtask-plan                    # 调研需求，创建任务
/devtask:devtask-simple                  # 简单任务快速落库
/devtask:devtask-doit                    # 领取 frontier 最前排任务执行
/devtask:devtask-doit task-42            # 执行指定 slug 的任务
/devtask:devtask-review task-42          # 验收条件 + 四视角代码审查

/devtask:devtask-setup                      ← 首次：初始化 + 写引导
    │
    ▼
需求描述
    │
    ▼
/devtask:devtask-grill
    │  探讨方案 → 选定方向
    │  (方案明确后进入 plan 或 simple)
    ▼
/devtask:devtask-plan / /devtask:devtask-simple
    │  访谈式调研 → 产出规格 → 创建任务
    ▼
/devtask:devtask-doit [task-N]
    │  端到端执行 → 自检验收条件 → /devtask:devtask-review
    ▼
/devtask:devtask-review [task-N]
    │  验收条件 + 四视角清理审查 + 正确性审查
    ▼
标记已完成

DevTaskMcp/
├── .claude-plugin/
│   ├── plugin.json              # Plugin 清单（元数据 + MCP server 引用）
│   └── marketplace.json         # 市场发布配置（3 个技能）
├── .mcp.json                    # MCP server 定义（plugin 自动加载）
├── skills/
│   ├── devtask-setup/SKILL.md   # 初始化：检查环境 + 写 CLAUDE.md 引导
│   ├── devtask-grill/SKILL.md   # 探讨方案选型与权衡
│   ├── devtask-plan/SKILL.md    # 需求 → 规格 → 创建
│   ├── devtask-simple/SKILL.md  # 简单任务快速落库
│   ├── devtask-doit/SKILL.md    # 端到端执行 + verify 门控
│   └── devtask-review/SKILL.md  # 验收条件 + 四视角清理审查 + 正确性审查
├── src/devtask_mcp/             # MCP server Python 包
│   ├── __init__.py
│   ├── client.py                # HTTP client，信封剥离
│   ├── models.py                # Pydantic 模型 + 中文枚举
│   └── server.py                # FastMCP，6 个工具注册（已 slug 化）
├── pyproject.toml
├── CLAUDE.md
└── README.md