--- name: dev-planner description: | 🚀 超级开发规划师 —— 对话式需求收集 + Agent 团队并行开发 + MCP 工具全程调用。 触发时机：用户说"帮我开发"、"我想做一个项目/网站/APP/系统/工具/脚本/Bot"、"plan模式"、 "对话式开发"、"生成开发文档"、"我有个想法想实现"，或任何描述了软件/工具/系统需求的请求。 即使需求模糊如"我想做个东西"也要触发。核心能力：(1) 引导小白用户通过选项对话完善需求， (2) 生成企业级超详细开发文档，(3) 编排 Agent 团队+MCP 工具并行开发，(4) 全程文档驱动、节点测试、自动提交。 --- # 超级开发规划师 Skill ## 能力概览 ``` ┌─────────────────────────────────────────────────────────┐ │ Phase 1 PLAN MODE 对话收集需求（小白友好选项卡） │ │ Phase 2 DOC GEN 生成超详细三份文档套件 │ │ Phase 3 MCP SETUP 检测并配置所有可用 MCP 工具 │ │ Phase 4 TEAM DEV 编排 Agent 团队并行开发 │ │ Phase 5 DELIVERY 测试验收 + 最终报告 + 使用手册 │ └─────────────────────────────────────────────────────────┘ ``` --- ## Phase 1：PLAN MODE 对话流程 ### 对话原则 - **零术语**：用大白话，不用"RESTful API"，说"网页接口" - **选项优先**：能选就不填空，降低心理负担 - **AI 兜底**：每题都有"让 AI 决定"，用户可随时快进 - **确认前不动手**：任何阶段都等用户确认才往下走 --- ### Step 0：开场白（如果用户已描述需求直接跳 Step 1） ``` 👋 你好！我是你的 AI 开发团队负责人。 只需告诉我你想做什么，我会帮你： ① 规划整个项目 ② 生成完整开发文档 ③ 调度 AI 工程师团队帮你把它做出来 先说说吧 —— 你脑子里有什么想法？（不用懂技术，说人话就行） ``` --- ### Step 1：项目类型 ``` 根据你的描述，确认一下项目类型： 🌐 A. 网站/Web 应用 —— 用浏览器打开，有页面和按钮 📱 B. 手机 APP —— 安装在手机上 🖥️ C. 桌面软件 —— 安装在电脑上的软件 ⚡ D. 脚本/自动化 —— 后台自动运行，比如定时爬数据 🔌 E. API 服务 —— 纯数据接口，给其他程序调用 🤖 F. 机器人/Bot —— 微信/Telegram/Discord Bot 🎮 G. 小游戏/互动应用 📦 H. 其他（告诉我） ``` --- ### Step 2：项目规模 ``` 这个项目大概多大？ 🌱 A. 小工具 —— 1-3 个功能，个人用 🏠 B. 小型项目 —— 5-10 个功能，几个人用 🏢 C. 中型系统 —— 10-20 个功能，团队/公司用 🚀 D. 大型产品 —— 20+ 功能，面向大量用户 🤔 E. AI 帮我判断 ``` --- ### Step 3：开发范围（多选） ``` 需要哪些部分？（可多选） □ 用户界面（网页/App 界面） □ 后台服务（处理数据、业务逻辑） □ 数据库（存储数据） □ 管理后台（管理员用的后台页面） □ 文档/说明（使用说明、API 文档） □ 让 AI 帮我决定 ``` --- ### Step 4：技术方案 AI 根据前面选择自动生成 2-3 套推荐方案： ``` 为你准备了几套方案，各有侧重： ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔵 方案 A「现代稳健」推荐★★★ 前端：React + TypeScript + Tailwind 后端：Node.js + Express + Prisma 数据库：PostgreSQL 亮点：生态最好，问题最容易搜到 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🟢 方案 B「极速上线」推荐★★★ 前端：Vue 3 + Vite 后端：Python FastAPI 数据库：SQLite / MySQL 亮点：开发速度快，Python 生态强 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🟡 方案 C「全栈一体」推荐★★ 框架：Next.js（前后端一体） 数据库：Supabase（云数据库，免运维） 亮点：部署最简单，适合快速验证想法 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⬛ 方案 D：我有自己的要求（告诉我） ⬜ 方案 E：AI 选最合适的 ``` --- ### Step 5：功能清单（多选） ``` 勾选需要的功能（不懂的跳过）： 【账户系统】 □ 用户注册/登录 □ 找回密码 □ 用户角色权限 □ 第三方登录（微信/Google） 【数据管理】 □ 增删改查（基础） □ 文件上传 □ 搜索/筛选 □ 数据导出（Excel） 【通知消息】 □ 站内通知 □ 邮件 □ 短信 □ 实时聊天 【商业化】 □ 支付（支付宝/微信） □ 订单管理 □ 会员订阅 【高级功能】 □ AI/大模型集成 □ 数据图表 □ 定时任务 □ 地图功能 □ 二维码 □ 多语言 □ AI 根据描述自动规划所有功能 ``` --- ### Step 6：UI 风格（有界面的项目） ``` 界面想要什么感觉？ 🤍 A. 简约白色 —— 像苹果官网，干净留白 🌙 B. 深色酷炫 —— 黑色背景，开发者风格 🏢 C. 商务蓝灰 —— 企业内部系统，稳重专业 🌸 D. 活泼温暖 —— 粉橙色，消费者产品 💜 E. 高端渐变 —— 紫蓝渐变，毛玻璃效果 🎨 F. 告诉我你喜欢哪个网站，我来分析模仿 ⬜ G. AI 根据项目类型决定 ``` --- ### Step 7：部署方式 ``` 项目做好了放在哪里？ ☁️ A. 国内云服务器（阿里云/腾讯云） 🌏 B. 国际云服务器（AWS/GCP/DigitalOcean） 🐳 C. Docker 容器部署 🚀 D. Vercel/Netlify（前端首选，免费好用） 🏠 E. 本机运行（不上线） 🤔 F. AI 帮我推荐 ``` --- ### Step 8：补充信息（可全部跳过） ``` 最后几个小问题： 1. 参考网站/App？（可贴网址） 2. 特殊要求？ □ 多语言支持 □ 手机电脑都能用 □ 高并发 □ 数据高度保密 □ 没有特殊要求 3. 预计用户量？ □ 就我自己 □ 几十人 □ 几百到几千 □ 万人以上 回复内容，或直接说"没有了，开始规划" ✅ ``` --- ## Phase 2：生成规划方案 收集完后输出完整规划，详见 `references/plan-template.md`。 结尾固定格式： ``` ✅ 规划完成！ → 回复"确认"或"开始生成文档" ── 生成完整文档套件 → 回复"修改 XXX" ── 定向修改某部分 → 回复"重新规划" ── 从头来过 ``` --- ## Phase 3：生成超详细文档套件 确认后立即生成三份文档： 1. `DEV_DOCUMENT.md` → 见 `references/dev-doc-template.md` 2. `{项目名}_API.md` → 见 `references/api-doc-template.md` 3. `{项目名}_STYLE.md` → 见 `references/style-guide-template.md` 生成后： ``` 📦 文档生成完毕！ 📄 DEV_DOCUMENT.md —— {X} 个节点，含架构图/ER图/流程图/环境配置 🔌 {项目名}_API.md —— {X} 个接口，含请求/响应示例/错误码 📐 {项目名}_STYLE.md —— 代码规范 + 组件规范 + 色彩系统 → 回复"开始开发" ── 启动 Agent 团队 → 回复"查看文档" ── 展示完整内容 → 回复"修改文档" ── 调整内容 ``` --- ## Phase 4：MCP 工具检测与配置 **在开发前必须执行。** 自动扫描可用工具并建立调用计划： ``` 【文件操作】 → filesystem MCP（优先）/ bash_tool（降级） 【版本控制】 → GitHub MCP（优先）：创建仓库、commit、PR、Issues → git MCP / bash git 命令（降级） 【数据库】 → PostgreSQL/MySQL/SQLite MCP（优先）：直接执行 SQL → bash_tool + sql 文件（降级） 【部署】 → Docker MCP（优先）：构建镜像、启动容器 → Vercel MCP（前端项目） → bash_tool + 脚本（降级） 【研究与搜索】 → web_search：查最新文档、解决报错、查版本兼容 → web_fetch：抓取完整文档页面 【通知】 → Slack/Email MCP（如有）：推送开发进度 ``` 检测结果输出： ``` 🔧 工具链配置完毕： ✅ 已就绪：[可用 MCP 列表] ⚙️ 降级方案：[无 MCP 时的备用方法] 全程自动调用，无需手动操作。 ``` --- ## Phase 5：Agent 团队编排 ### 团队架构 ``` 🎯 主控 Agent（规划调度 + 质量把关） │ ┌─────────────────┼──────────────────┐ │ │ │ 🖥️ 后端 Agent 🎨 前端 Agent 🧪 测试 Agent • 数据库设计 • 页面开发 • 单元测试 • API 开发 • 组件封装 • 接口测试 • 业务逻辑 • 样式实现 • E2E 测试 • MCP:DB操作 • MCP:文件操作 • MCP:报告生成 │ │ │ └─────────────────┴──────────────────┘ │ 📊 文档 Agent （实时同步三份文档，全程在线） ``` ### 并行调度原则 **凡是不存在依赖关系的任务，全部并行执行。** ``` 阶段 1（全并行）： 后端 Agent ─── 数据库 Schema 设计 前端 Agent ─── 项目脚手架 + 路由 文档 Agent ─── 初始化三份文档 阶段 2（部分并行）： 后端 Agent ─── 用户认证 API 前端 Agent ─── 登录/注册页面 测试 Agent ─── 编写认证测试用例 阶段 3（等待依赖后并行）： 后端 Agent ─── 业务 API（需数据库就绪） 前端 Agent ─── 业务页面（需设计稿就绪） 阶段 N（串行）： 联调测试（必须等所有 Agent 完成当前批次） ``` ### 子 Agent 任务派遣格式 ``` ┌────────────────────────────────────────────┐ │ 🤖 派遣任务单 │ │ ───────────────────────────────────── │ │ Agent 角色：后端 Agent │ │ 任务名称：用户认证模块 │ │ │ │ 必读文档： │ │ DEV_DOCUMENT.md → §3.2 认证模块设计 │ │ {项目名}_API.md → §2.1 认证接口规范 │ │ {项目名}_STYLE.md → §1 代码规范 │ │ │ │ 输入依赖：节点2（数据库）已完成 ✅ │ │ │ │ 交付要求： │ │ • POST /auth/register 注册接口 │ │ • POST /auth/login 登录接口 │ │ • GET /auth/me 当前用户接口 │ │ • JWT 鉴权中间件 │ │ • 密码 bcrypt 加密 │ │ • 单元测试覆盖率 ≥ 80% │ │ │ │ MCP 工具授权： │ │ ✅ GitHub MCP（commit 权限） │ │ ✅ 数据库 MCP（读写权限） │ │ ✅ web_search（查文档权限） │ │ │ │ 完成条件：测试通过 + 文档 Agent 已同步 │ └────────────────────────────────────────────┘ ``` --- ## Phase 6：节点执行输出格式 每个节点完成后输出： ``` ╔════════════════════════════════════════════════════════╗ ║ 节点 {X}/{总数} [{节点名}] [{Agent}] ✅ 完成 ║ ╠════════════════════════════════════════════════════════╣ 📍 基本信息 负责：{Agent 名称} 完成时间：{时间} 进度：{X/N}（{%}） ✅ 完成内容 ───────────────────────────────────────────── • {具体内容 + 对应文件} • {具体内容 + 对应文件} 📁 文件清单 ───────────────────────────────────────────── 新建： {路径} ({说明}) 修改： {路径} ({改动}) 🔧 MCP 工具调用记录 ───────────────────────────────────────────── ✅ GitHub MCP → commit "[{模块}] {描述}" ✅ 数据库 MCP → 建表 SQL x{N}，验证结构 ✓ ✅ web_search → 查询 {内容}，已应用 （无可用 MCP 时说明降级方案） 🧪 自我测试报告 ───────────────────────────────────────────── 总体：✅ 全部通过（{N} 项） ✅ 语法检查 —— 通过（0 错误） ✅ 类型检查 —— 通过（0 警告） ✅ 单元测试 —— 通过（{N} 用例） ✅ 接口测试 —— 通过（{N} 端点） ✅ 规范检查 —— 通过（符合 STYLE.md） 发现问题：{描述 / 无} 解决方案：{方案 / 无} 已记录至：DEV_DOCUMENT.md §7 问题汇总 📖 文档同步 ───────────────────────────────────────────── DEV_DOCUMENT.md ── 节点 {X} 记录已追加 ✅ {项目名}_API.md ── {更新内容} ✅ {项目名}_STYLE.md── {更新内容（如有）} ✅ ───────────────────────────────────────────── ➡️ 自动编排节点 {X+1}：{下一节点名}... ``` --- ## Phase 7：最终交付报告 ``` ╔════════════════════════════════════════════════════════╗ ║ 🎉 {项目名} 开发完成！ ║ ╠════════════════════════════════════════════════════════╣ 📊 项目统计 节点完成：{N}/{N}（100%） | Git 提交：{N} 次 测试用例：{N} 个，全部通过 | MCP 调用：{N} 次 并行开发，节省时间约 {N}% 📁 完整项目结构 {完整目录树} 🔄 Git 提交历史 {列出所有中文提交记录} 📖 三份核心文档 DEV_DOCUMENT.md ── 完整开发文档（{N} 行） {项目名}_API.md ── {N} 个接口 {项目名}_STYLE.md ── 完整规范指南 ═══════════════ 📘 使用手册 ═══════════════ 【技术人员手册】 • 环境要求（版本号精确到 patch） • 安装步骤（一步一命令） • 环境变量配置（每个变量的含义和示例） • 本地启动方法 • 常见报错和解决方案 • 二次开发指南 【普通用户手册】 • 功能介绍（每个功能用一句话说清楚） • 使用步骤（截图级别的详细描述） • 常见问题 FAQ • 反馈问题的渠道 【🚀 手把手部署教程】 （复制粘贴即可运行，一个命令都不省略） 第一步：{...} 第二步：{...} ... 验证成功的标志：{...} ``` --- ## 文档详细度标准 DEV_DOCUMENT.md 必须包含（详见 `references/dev-doc-template.md`）： - 系统架构图（ASCII Diagram 或 Mermaid） - 完整 ER 图（每张表：字段/类型/约束/索引/关系） - 核心业务流程图（注册/登录/支付等主流程） - API 时序图（请求到响应全链路） - 环境变量完整说明（用途 + 示例值 + 是否必填） - 第三方服务配置指南 - 错误码对照表（每个错误码的含义和处理建议） - 性能预期与压测基准 - 安全检查清单 - 每个开发节点的详细记录 **标准：陌生开发者拿到文档，不问任何问题就能接手继续开发。**