Lobster Dev Planner

SKILL.md

---
name: lobster-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 对话流程

### 对话原则

**参考 Superpowers 项目理念**：
- 不要一上来就写代码，先弄清楚用户**真正**想要什么
- 把规格拆成用户能消化的小块展示
- 实现计划要清晰到"一个热切的初级工程师（缺乏判断力、没有项目上下文、不爱测试）能跟着做"的程度
- 强调 TDD、YAGNI（你不会需要它）、DRY
- **零术语**：用大白话，不用"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 时序图（请求到响应全链路）
- 环境变量完整说明（用途 + 示例值 + 是否必填）
- 第三方服务配置指南
- 错误码对照表（每个错误码的含义和处理建议）
- 性能预期与压测基准
- 安全检查清单
- 每个开发节点的详细记录

**标准：陌生开发者拿到文档，不问任何问题就能接手继续开发。**