DevPlan MCP Server

DevPlan MCP 服务

将想法转化为可执行的开发计划 —— 一个将 ClaudeCode-DevPlanBuilder 方法论引入 Claude Code 的 MCP 服务。

问题：AI 编码助手常常会丢失上下文、跳过步骤，或在不同会话中生成不一致的代码。

解决方案：DevPlan 能创建详细的、可由 Agent 执行的开发计划，并内置验证、经验教训和行内 git 工作流。

---

新增 — 安装为 Skill（无需 MCP 服务）

DevPlan 现已作为独立的 Claude Code Skill 提供 —— 无需 MCP 服务、无需网络依赖，也不会遇到 SSE 超时。完整的 DevPlan 方法论作为一等插件在本地运行。

安装

步骤 1 — 将此仓库添加为插件市场：

/plugin marketplace add mmorris35/devplan-mcp-server

步骤 2 — 在用户级别安装插件（适用于所有项目）：

/plugin install devplan@mmorris35 --scope user

步骤 3 — 重新加载插件以启用：

/reload-plugins

使用方法

直接调用 Skill：

/devplan

或使用特定子命令：

/devplan brief          — Create or parse a PROJECT_BRIEF.md
/devplan plan           — Generate a Haiku-executable DEVELOPMENT_PLAN.md
/devplan agents         — Generate executor (Haiku) and verifier (Sonnet) agents
/devplan claude-md      — Generate a project CLAUDE.md
/devplan validate       — Check plan structure and Haiku-executability
/devplan progress       — Show completion status
/devplan export mermaid — Generate a Mermaid flowchart of the plan
/devplan issue <number> — Convert a GitHub issue to a remediation task
/devplan implement      — Kickoff the build with executor + verifier agents

也可以直接描述你的需求 —— Claude 会自动调用 Skill：

"Help me plan a CLI tool for managing dotfiles"
"Create a development plan for this project"
"Validate my development plan"

包含内容

skills/devplan/
├── SKILL.md                 — Core methodology, interview flow, dispatch
├── references/
│   ├── templates.md         — Brief/plan/CLAUDE.md templates (CLI, web app, API, library)
│   ├── validation.md        — Structure + Haiku-executability rules + battle-tested lessons
│   ├── agents.md            — Executor and verifier agent generation patterns
│   └── workflows.md         — Mermaid/ReactFlow export + progress tracking
├── scripts/
│   ├── validate-plan.sh     — Structural validation (standalone)
│   └── check-haiku.sh       — Haiku-executability checker (standalone)
└── examples/
    └── hello-cli-plan.md    — Gold standard reference plan

Skill 与 MCP 服务对比

	Skill（新增）	MCP 服务
网络	无需网络	通过 SSE 连接到 Cloudflare
可靠性	始终可用	可能遇到 SSE 超时
经验教训系统	使用 Nellie 或你自己的方案	内置 KV 存储
安装	/plugin install	claude mcp add
验证脚本	独立 bash 脚本	服务端运行

两种方案都受到完整支持。推荐使用 Skill，以获得更高可靠性；MCP 服务则额外提供经验教训系统和使用分析。

---

主要功能

功能	说明
可由 Agent 执行的计划	计划足够详细，任何 LLM 编码 Agent 都能按步骤机械地执行
内置验证	在开始执行前验证计划是否完整
实时进度跟踪	集成 Claude Code 的 Task 工具，实时查看进度
经验教训	收集验证过程中发现的问题，并将其注入未来的计划
问题修复	将 GitHub 问题直接转换为修复任务
执行者与验证者 Agent	自动生成内置任务跟踪功能的专用 Agent

安装

claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user

或者在 ~/.claude.json 的 mcpServers 键下添加：

{
  "mcpServers": {
    "devplan": {
      "type": "sse",
      "url": "https://mcp.devplanmcp.store/sse"
    }
  }
}

更新现有安装

如果你已经安装了 DevPlan，请从两个作用域中移除，然后重新添加：

claude mcp remove devplan --scope project; claude mcp remove devplan --scope user; claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user

快速开始

You: "Use devplan_start to help me build a CLI tool for managing dotfiles"

就是这样。DevPlan 将引导 Claude 完成整个流程。

DevPlan 工作流

DevPlan 使用搭建骨架 → 增强 → 验证工作流，确保每个计划在开始实施前都可由 Agent 执行。

flowchart LR
    subgraph Planning["📋 Planning"]
        A[Interview] --> B[Brief]
        B --> C[Generate Scaffold]
    end

    subgraph Enhancement["✨ Enhancement"]
        C --> D[Enhance with Code]
        D --> E{Validate}
        E -->|Fail| D
        E -->|Pass| F[Ready]
    end

    subgraph Execution["⚡ Execution"]
        F --> G[Agent Executes]
        G --> H[Agent Verifies]
    end

    subgraph Learning["🧠 Learning"]
        H -->|issues| I[Capture Lessons]
        I -->|improve| C
    end

    style E fill:#fff3e0,stroke:#f57c00
    style F fill:#c8e6c9,stroke:#2e7d32
    style I fill:#e3f2fd,stroke:#1565c0

工作原理

1. 访谈 → DevPlan 会提问以了解你的项目
2. 项目简报 → 创建包含需求的结构化 PROJECT_BRIEF.md
3. 生成骨架 → devplan_generate_plan 创建基础阶段和功能列表
4. 使用代码增强 → 你的 AI Agent 整理功能阶段，并填入完整、可直接复制粘贴的代码
5. 验证 → devplan_validate_plan 检查计划是否可由 Agent 执行
6. 执行 → 执行者 Agent 使用行内 git 命令实现每个子任务
7. 验证实现 → 验证者 Agent 尝试找出实现中的问题
8. 总结经验 → 将问题转化为未来项目的经验教训

验证确保质量

验证步骤会检查计划是否真正可执行：

• ✅ 代码块完整（不是伪代码或占位内容）
• ✅ 代码块中包含所有导入项
• ✅ 没有“添加到现有内容中”之类的指示
• ✅ 没有跨子任务引用
• ✅ 提供带有预期输出的验证命令

# Example validation output
{
  "valid": true,
  "errors": [],
  "warnings": [],
  "stats": {
    "subtasks": 5,
    "codeBlocksChecked": 8,
    "issuesFound": 0
  }
}

使用任务工具实时查看进度

生成的执行器和验证器 Agent 会集成 Claude Code 的 Task 工具，实时显示进度：

• 执行器 Agent会为每个子任务创建任务，随着工作推进显示实时旋转指示器
• 验证器 Agent会为每个验证阶段（冒烟测试、功能验证、边界情况等）创建任务
• 无需滚动即可查看进度——你始终知道 Claude 正在处理什么

# Example: Executor tracks subtasks
TaskCreate({ subject: "1.2.3: Implement auth middleware", activeForm: "Implementing auth middleware" })
TaskUpdate({ taskId: "...", status: "in_progress" })
# ... work happens ...
TaskUpdate({ taskId: "...", status: "completed" })

Task 工具（实时查看）和 DEVELOPMENT_PLAN.md（持久记录）都会更新——让你兼得两者之长。

使用示例

新建项目

"Use devplan_start to help me build [your idea]"

修复 GitHub 问题

# Get issue JSON
gh issue view 123 --json number,title,body,labels,comments,url > issue.json

# Then tell Claude:
"Use devplan_issue_to_task with this issue to create a remediation plan"

查看进度

"Use devplan_progress_summary to show me where we are"

多模型支持

DevPlan 可为多种 AI 编码工具和模型生成计划及 Agent 文件。使用 target 参数为你偏好的工具生成输出。

支持的目标

目标	工具	Agent 文件	适用场景
claude	Claude Code	CLAUDE.md	Claude Code IDE（默认）
cursor	Cursor IDE	.cursorrules	Cursor AI 编辑器
aider	Aider CLI	.aider.conf.yml	基于终端的 AI 结对编程
cline	VS Code Cline	.cline/instructions.md	VS Code 扩展
windsurf	Windsurf IDE	.windsurf/rules.md	Codium 的 AI IDE
generic	任意模型	AGENTS.md + 文件	与模型无关的 Markdown 格式

使用目标

生成计划或 Agent 文件时，请指定目标工具：

为 Cursor 生成计划：

"Use devplan_generate_plan to create a plan, then I'll customize it for Cursor. Set target to 'cursor' for .cursorrules format"

为 Aider 生成执行器：

"Use devplan_generate_executor with target='aider' to create an Aider-compatible executor agent"

生成通用 Agent 文件：

"Use devplan_generate_claude_md with target='generic' to create model-agnostic AGENTS.md files"

目标的工作方式

每个目标都有专用的适配器，可将 DevPlan 方法转换为相应格式：

• Claude - 生成 CLAUDE.md，并在 .claude/agents/ 中生成执行器/验证器 Agent
• Cursor - 生成 .cursorrules，将所有指导内容放在一个文件中（Cursor 不支持独立的 Agent）
• Aider - 生成 .aider.conf.yml，其中包含架构师模式指令
• Cline - 生成 .cline/instructions.md，其中包含执行器/验证器拆分
• Windsurf - 生成 .windsurf/rules.md，采用针对 Cascade 优化的格式
• 通用 - 为任意工具生成 AGENTS.md、EXECUTOR.md 和 VERIFIER.md

示例

为 Cursor 启动新项目：

"Use devplan_start to help me build a CLI tool, then generate the plan with target='cursor' for Cursor IDE"

为特定目标添加执行器：

"I have a development plan. Use devplan_generate_executor with target='aider' to create the executor agent for Aider"

比较适配器功能： 请参阅 docs/ADAPTERS.md，详细了解各目标的功能和限制。

工具

规划

工具	用途
devplan_start	主要入口——引导 Claude 使用此方法
devplan_interview_questions	获取用于收集项目需求的问题
devplan_create_brief	生成 PROJECT_BRIEF.md
devplan_parse_brief	将现有简介解析为结构化数据
devplan_list_templates	列出项目模板（cli、web_app、api、library）

生成

工具	用途
devplan_generate_plan	生成 DEVELOPMENT_PLAN.md 框架，并附带验证说明
devplan_generate_claude_md	生成 CLAUDE.md 框架
devplan_generate_executor	生成集成 Task 工具的执行器 Agent
devplan_generate_verifier	生成集成 Task 工具的验证器 Agent

验证与执行

工具	用途
devplan_validate_plan	验证计划结构及其可由 Agent 执行性
devplan_get_subtask	根据 ID 获取特定子任务的详情
devplan_update_progress	标记子任务已完成并附上备注
devplan_progress_summary	获取完成情况统计和后续操作

经验教训

从验证过程中收集问题，并将其纳入后续计划的反馈循环。

工具	用途
devplan_add_lesson	根据验证器的发现记录经验教训
devplan_list_lessons	按严重程度列出累积的经验教训
devplan_archive_lesson	归档旧经验教训，但不删除
devplan_delete_lesson	移除过时或不正确的经验教训
devplan_extract_lessons_from_report	从验证报告中自动提取经验教训

问题修复

将 GitHub 问题转换为结构化修复任务，非常适合修复 Bug 和发布后的维护工作。

工具	用途
devplan_parse_issue	分析 GitHub 问题以提取需求
devplan_issue_to_task	根据问题生成包含子任务的修复任务

分析

工具	用途
devplan_usage_stats	查看不同用户的使用情况分布

为什么选择 DevPlan？

不使用 DevPlan	使用 DevPlan
会话之间的上下文丢失	计划保留完整上下文
代码质量不一致	执行 Agent 遵循精确的规范
重复犯相同的错误	经验教训系统可防止问题重演
没有验证步骤	验证 Agent 会主动尝试破坏代码
Bug 在生产环境中才被发现	在发布前发现问题
计划需要解读	经过验证的计划可直接复制粘贴使用

仪表板与分析

DevPlan 提供了一个公开仪表板，用于查看汇总的使用情况统计：

仪表板 URL：devplanmcp.store/dashboard

仪表板显示：

• 摘要卡片：会话总数、工具调用总数、覆盖的国家/地区
• 折线图：过去 30 天的会话数和工具调用数
• 国家/地区表格：按会话数排名前 10 的国家/地区

隐私

所有分析数据都能保护隐私：

• 不存储 IP：仅存储由 Cloudflare 推导的国家/地区代码
• 不识别用户：会话均为匿名
• 自动过期：每日统计数据通过 KV TTL 在 90 天后过期

开发

npm install
npm run dev      # Local development
npm run deploy   # Deploy to Cloudflare Workers

参与贡献

欢迎贡献！有关方法论的详情，请参阅 ClaudeCode-DevPlanBuilder 仓库。

许可证

MIT

---

为 Claude Code 构建
Model Context Protocol • Cloudflare Workers • DevPlanBuilder 方法论