开发计划生成工具

DevPlan MCP Server是一个AI驱动的开发计划生成工具,可将项目构思转化为可执行的详细开发计划,内置验证机制和实时进度跟踪功能,适用于软件开发全周期管理。

  • by mmorris35
  • TypeScript
  • 云端部署
  • 7 星标
  • 更新于
在 GitHub 查看 mmorris35/devplan-mcp-server

使用说明

DevPlan MCP服务器

将想法转化为可执行的开发计划 --MCP服务器,它带来 ClaudeCode开发计划生成器 Claude Code的方法论。

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

解决方案:DevPlan创建了详细的、代理可执行的开发计划,其中包含内置验证、经验教训和内联git工作流。


新增--安装技能(无需MCP服务器)

DevPlan现在可以作为 独立Claude代码技能 --无MCP服务器,无网络依赖性,无SSE超时。整个DevPlan方法论在本地作为一个一流的插件运行。

安装

步骤1 --将此仓库添加为插件市场:

/plugin marketplace add mmorris35/devplan-mcp-server

步骤2 --在用户范围内安装插件(适用于所有项目):

/plugin install devplan@mmorris35 --scope user

步骤3 --重新加载插件以激活:

/reload-plugins

用法

直接调用技能:

/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

或者只是描述你需要什么——克劳德会自动调用该技能:

"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

技能vs MCP服务器

技能(新) MCP服务器
网络 无需 SSE连接到Cloudflare
可靠性 始终有效 受SSE超时限制
课程体系 使用 内莉 或您自己的 内置KV商店
安装 /plugin install claude mcp add
验证脚本 独立bash 服务器端

这两个选项都得到了充分支持。推荐该技能的可靠性;MCP服务器添加了经验教训系统和使用分析。


主要特点

特性 描述
代理可执行计划 计划如此详细,以至于任何LLM编码代理都可以机械地执行它们
内置验证 在执行开始之前验证计划是否完整
实时进度跟踪 与Claude Code的任务工具集成,实现实时可见性
经验教训 从验证中捕获问题并将其注入未来的计划中
问题补救 将GitHub问题直接转化为补救任务
执行器和验证代理 自动生成内置任务跟踪的专用代理

安装

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将指导克劳德完成整个过程。

DevPlan工作流程

DevPlan使用 脚手架→ 增强→ 验证 工作流,确保每个计划在实施开始前都是代理可执行的。

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代理结构具有阶段特征,并填写完整的可复制粘贴代码
  5. 验证 → devplan_validate_plan 检查计划是否可由代理执行
  6. 执行 → 执行器代理使用内联git命令实现每个子任务
  7. 验证 → 验证器代理试图破坏实现
  8. 学习 → 问题成为未来项目的教训

验证确保质量

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

  • ✅ 完整的代码块(不是伪代码或占位符)
  • ✅ 代码块中包含的所有导入
  • ✅ 无“添加到现有”说明
  • ✅ 无交叉子任务引用
  • ✅ 具有预期输出的验证命令
# Example validation output
{
  "valid": true,
  "errors": [],
  "warnings": [],
  "stats": {
    "subtasks": 5,
    "codeBlocksChecked": 8,
    "issuesFound": 0
  }
}

任务工具的实时进度

生成的执行器和验证器代理与Claude Code的任务工具集成,以实现实时进度可见性:

  • 执行人代理人 为每个子任务创建任务,随着工作的进展显示实时微调器
  • 验证器代理 为每个验证阶段(烟雾测试、功能验证、边缘案例等)创建任务
  • 无需滚动即可看到进展——你总是知道克劳德在做什么
# 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" })

任务工具(实时可见性)和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编码工具和模型生成计划和代理文件。使用 target 参数为您的首选工具生成输出。

支持的目标

目标 工具 代理文件 最适合
claude 克劳德代码 CLAUDE.md 克劳德代码IDE(默认)
cursor 光标IDE .cursorrules 光标AI编辑器
aider 助手CLI .aider.conf.yml 基于终端的AI配对编程
cline VS代码库 .cline/instructions.md VS代码扩展
windsurf Windsurf IDE .windsurf/rules.md Codium 的 AI IDE
generic 任何型号 AGENTS.md +文件 与模型无关的markdown格式

使用目标

生成计划或代理文件时,指定目标工具:

为Cursor生成计划:

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

为助手生成执行器:

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

生成通用代理文件:

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

目标如何运作

每个目标都有一个专用 适配器 将DevPlan方法论转换为适当的格式:

  • 克劳德 -生成 CLAUDE.md 其中包含执行者/验证者代理 .claude/agents/
  • 光标 -生成 .cursorrules 所有指导都在一个文件中(Cursor不支持单独的代理)
  • 教唆者 -生成 .aider.conf.yml 使用架构师模式指令
  • 克莱恩 -生成 .cline/instructions.md 执行者/验证者分离
  • 帆板运动 -生成 .windsurf/rules.md 采用级联优化格式
  • 通用的 -生成 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 生成项目_BRIEF.md
devplan_parse_brief 将现有简报解析为结构化数据
devplan_list_templates 列出项目模板(cli、web_app、api、库)

生成

工具 目的
devplan_generate_plan 生成带有验证说明的DEVELOPMENT_PLAN.md脚手架
devplan_generate_claude_md 生成CLAUDE.md脚手架
devplan_generate_executor 使用任务工具集成生成执行器代理
devplan_generate_verifier 使用任务工具集成生成验证器代理

验证与执行

工具 目的
devplan_validate_plan 验证计划结构和代理的可执行性
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
会话之间的上下文丢失 计划保留完整的上下文
代码质量不一致 执行器代理遵循精确的规范
重复同样的错误 经验教训系统可防止再次发生
无验证步骤 验证器代理主动尝试破解代码
生产中发现的错误 发布前发现的问题
计划需要解释 已验证的计划已准备好复制粘贴

仪表板和分析

DevPlan包括一个公共仪表板,用于查看汇总使用统计数据:

仪表板URL: devplanmcp.store/仪表板

仪表板显示:

  • 摘要卡片:会议总数、工具调用总数、到达的国家
  • 折线图:过去30天的会议和工具调用
  • 国家表:按会议次数排列的前10个国家

隐私

所有分析都是保护隐私的:

  • 无IP存储:只有Cloudflare衍生的国家/地区代码
  • 无用户标识:会话是匿名的
  • 自动过期:每日统计数据通过KV TTL在90天后过期

发展

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

贡献

欢迎投稿!请查看 ClaudeCode开发计划生成器 repo以获取方法细节。

许可证

麻省理工学院


Built for Claude Code
Model Context Protocol • Cloudflare Workers • DevPlanBuilder Methodology