Windsurf 接入 Maple MCP/Skills

目标

• 在 Windsurf 中接入 Maple MCP（别名）。
• 启用仓库内的 /maple 工作流命令。
• 让任务执行与判定统一走 Maple MCP + Maple Skills 链路。

1) 配置 Windsurf MCP

推荐先运行一键安装脚本（会自动写入 MCP 配置并生成 workflow）：

bash scripts/installers/install-maple-windsurf.sh

也可以手动创建或更新 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "maple": {
      "url": "http://localhost:45819/mcp"
    }
  }
}

确保 Maple 桌面应用已启动（MCP 服务器随应用自动运行），然后重启 Windsurf。

2) 启用 /maple 工作流

本仓库已提供工作流文件：

• .windsurf/workflows/maple.md

Windsurf 会把 maple.md 映射为 /maple 命令。重启或刷新工作区后可直接使用。

3) 使用方式

在 Windsurf 聊天中输入：

/maple

执行过程会先查询 Maple 项目待办与近期上下文，再按技能链路执行并给出结论。

4) 判定规则（已生效）

• Worker 输出必须包含 mcp_decision.status/comment/tags[]。
• 若缺少 mcp_decision，任务会被标记为 已阻塞，不会兜底为 已完成。
• 标签与结论记录仅采用 mcp_decision 结果。
• 每条任务必须通过 submit_task_report 驱动状态流转：开始先更新为 进行中，结束再更新为 已完成/已阻塞/需要更多信息。
• 调用 finish_worker 前必须再次 query_project_todos，确认无 待办/队列中/进行中 任务。
• finish_worker 必须作为最后一个 MCP 调用。

5) 一键安装脚本（Claude / Codex / iFlow / Windsurf）

仓库内提供安装脚本（MCP + Skills）：

bash scripts/maple-install.sh

或按 CLI 单独安装：

bash scripts/installers/install-maple-codex.sh
bash scripts/installers/install-maple-claude.sh
bash scripts/installers/install-maple-iflow.sh
bash scripts/installers/install-maple-windsurf.sh

也可以一次性安装全部：

bash scripts/installers/install-maple-all.sh

6) 独立执行边界

• /maple 默认只使用 Maple MCP 与 Maple Skills。
• 任务执行、验证与结论均在 Maple 链路内完成。
• 不引入外部任务系统依赖，避免执行路径分叉。

7) iFlow /skills list 验证

安装后执行 /skills list，应能看到：

• ~/.iflow/skills/SKILL.md
• ~/.iflow/skills/maple/SKILL.md