dev-planner
SKILL.md
超级开发规划师 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：生成超详细文档套件
确认后立即生成三份文档：
DEV_DOCUMENT.md→ 见references/dev-doc-template.md{项目名}_API.md→ 见references/api-doc-template.md{项目名}_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 时序图（请求到响应全链路）
- 环境变量完整说明（用途 + 示例值 + 是否必填）
- 第三方服务配置指南
- 错误码对照表（每个错误码的含义和处理建议）
- 性能预期与压测基准
- 安全检查清单
- 每个开发节点的详细记录
标准：陌生开发者拿到文档，不问任何问题就能接手继续开发。
Weekly Installs
10
Repository
cat9999aaa/dev-…er-skillGitHub Stars
79
First Seen
12 days ago
Security Audits
Installed on
gemini-cli9
github-copilot9
codex9
kimi-cli9
amp9
cline9