超级工作流
☑️BMad 结构化产出 (PRD/SDD/Code Review) bmad-create-prd / bmad-create-architecture / bmad-code-review
☑️Agency-Agents 135+ 领域专家 agent engineering-frontend-developer / engineering-backend-architect / qa-* / testing-*
☑️Superpowers 开发流程 11 步闭环 writing-plans ⇒ worktrees ⇒ TDD ⇒ 实现 ⇒ simplify ⇒ verify ⇒ code-review ⇒ handoff
☑️planning-with-files 持久层: .planning/ 三文件 task_plan.md + findings.md + progress.md
☑️MattPocock 领域语言对齐 + 架构审查 grill-with-docs ⇒ CONTEXT.md / improve-codebase-architecture / handoff 跨阶段交接
☑️CodeGraph AST 级代码知识图谱 C0.3-b: 符号依赖验证 / C2.2: 调度注入符号上下文 / D4.1: 符号级签名匹配 / D4.4: codegraph_impact 影响域分析
✅【提示词】
我需要搭建一个用于网站和小程序开发的工作流，用当前已经安装的技能
BMad，Agency-Agents，Superpowers，MattPocock，Karpathy四大原则，
一起来进行构建。
构建流程:
1. 由用户立项
2. 根据立项拆解项目需求，选择技术栈
3. 产出 PRD 需求文档，包括：
(1) 并发场景 (2) 前后端技术栈选型 (3) 前端界面需求
(4) 管理后端需求 (5) 数据库设计
4. 用户把 (3)(4) 交给 Pencil 做出可交付的 UI 原型
5. 用户把 UI 原型交给 OpenDesign 做出可交互的 UX 原型
6. 用户设置好数据库，把 IP/用户名/密码交给你建立连接
7. 把可交互 UX 原型交给你后，结合 PRD 进行项目开发。
开发中以 BMad 为指挥调度，选取 Agency-Agents 内不同领域专家，
使用 Superpowers、Karpathy、MattPocock 术语对齐和架构审查，
以及代码安全质量门禁。子代理并行/串行时用 planning-with-files 粘合上下文。
8.架构总览
┌─────────────────────────────────────────────────────────────────────────┐
│ 用户输入: 口头需求 / docs/需求.md │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ A: 需求 + 架构 │
│ ┌────────┐ ┌──────────┐ ┌────────┐ ┌───────┐ ┌────────┐ ┌──────┐ ┌────┐│
│ │ A0 │⇒│ A0.2 │⇒│ A1 │⇒│ A1.5 │⇒│ A2 │⇒│ A2.6 │⇒│A2.7││
│ │ 环境 │ │ grill- │ │ PRD │ │ 用户 │ │ SDD │ │ DB │ │后端││
│ │ 预检 │ │ with- │ │ bmad- │ │ 确认 │ │ 架构 │ │ 设计 │ │设计││
│ │ │ │ docs │ │ create │ │ │ │ │ │ │ │ ││
│ │ │ │ ⇒CONTEXT │ │ -prd │ │ │ │ │ │ │ │ ││
│ └────────┘ └──────────┘ └────────┘ └───────┘ └────────┘ └──────┘ └────┘│
│ │ │
│ ┌──────────▼──────────┐ │
│ │ 产出: │ │
│ │ docs/prd.md │ │
│ │ docs/sdd.md │ │
│ │ docs/database.md │ │
│ │ docs/backend- │ │
│ │ design.md │ │
│ │ CONTEXT.md │ │
│ │ docs/decisions/ │ │
│ └──────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ B: UI/UX 原型 + API 契约 (与 A2 并行) │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│ │ B-P │───⇒│ B2 │───⇒│ B3 │───⇒│ B3.5 │ │
│ │ OpenDesgn│ │ 原型分析 │ │ API 契约 │ │ 用户 │ │
│ │ /Pencil │ │ 提取token│ │ 设计 │ │ 确认 │ │
│ │ 原型制作 │ │ 组件/交互│ │ │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ └─────────┘ │
│ │ │ │
│ ┌────▼────┐ ┌────▼────┐ │
│ │ design- │ │ api- │ │
│ │ tokens │ │ contract│ │
│ │ .md │ │ .md │ │
│ │ comp- │ └─────────┘ │
│ │ spec.md │ │
│ │ ux- │ │
│ │ spec.md │ │
│ └─────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
A2.6~A2.7 并行 B1~B2 并行
(SDD+数据库+后端) (原型制作+分析)
│ │
└───────────────┬───────────────┘
▼
B3 API 契约 (串行, 依赖两者)
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ C: 开发实现 — Superpowers 引擎 │
│ │
│ ┌─── C0 结构化解构 ─────────────────────────────────────────────────┐ │
│ │ C0.1 读输入 ⇒ C0.2 按feature切 ⇒ C0.3 领域匹配 ⇒ │ │
│ │ C0.3-b CodeGraph符号 ⇒ C0.4 依赖图 ⇒ C0.5 契约协议 ⇒ │ │
│ │ C0.6 Task Schema ⇒ C0.7 Scope锁定 ⇒ C1 用户审查 │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─── C2: 按 Stage 并行 dispatch (≤3/批) ──────────────────────────┐ │
│ │ Stage 1 (task-1, task-4) Stage 2 (task-2, task-7) │ │
│ │ Stage 3 (task-3,5,8) 每 Stage: Gate (merge+烟雾) │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─── 每 task: Superpowers 闭环 ────────────────────────────────────┐ │
│ │ │ │
│ │ writing-plans ⇒ worktree ⇒ TDD(红绿) │ │
│ │ ⇒ sub-agent 实现 (注入 expert + CONTEXT + 契约 + scope │ │
│ │ + codegraph 符号上下文) │ │
│ │ ⇒ [FAIL? systematic-debugging] │ │
│ │ ⇒ simplify ⇒ verification-before-completion │ │
│ │ ⇒ 写契约 (docs/contracts/<id>.schema.md) │ │
│ │ ⇒ code-review ⇒ [REVISE? receiving-code-review] │ │
│ │ ⇒ handoff │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ 产出: 实现代码 + docs/contracts/ + pipeline-state.json │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ D: 质量门禁 │
│ │
│ ┌─── 三组并行 ─────────────────────────────────────────────────────┐ │
│ │ Group A (质量) Group B (测试) Group C (专项) │ │
│ │ ├─ CLAUDE.md 合规 ├─ 集成测试+覆盖率 ├─ UI 自动化 (Playwright) │ │
│ │ └─ Lint + 静态分析 ├─ 完成验证 ├─ 无障碍 (aXe) │ │
│ │ └─ E2E 测试 └─ 性能基准 │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─── D4: 汇总审查 ─────────────────────────────────────────────────┐ │
│ │ D4.1 规格合规审计 (codegraph_search 符号匹配) │ │
│ │ D4.2 bmad-code-review (Blind Hunter) + 锁定文件检查 │ │
│ │ D4.3 过度工程检查 │ │
│ │ D4.4 codegraph_impact 影响域分析 │ │
│ │ D4.5 improve-codebase-architecture 架构审查 │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─── D5: 汇总判定 ─────────────────────────────────────────────────┐ │
│ │ verification-before-completion ⇒ 用户审查决策 │ │
│ │ REVISE ⇒ receiving-code-review ⇒ 回到测试 │ │
│ │ PASS ⇒ 进入 E 阶段 │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─── 反馈回路 (最多 3 轮) ─────────────────────────────────────────┐ │
│ │ Loop 1: 自动修复 Loop 2: 自动修复+日志 │ │
│ │ Loop 3: 用户确认后修复 超限: 继续/部分放行/人工接管/终止 │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ E: 安全扫描 (可选, 触发条件: config开启 / --security / 涉及敏感数据) │
│ │
│ E1 git diff ⇒ 判定扫描范围 (只扫改动) │
│ E2 增量扫描: gitleaks(密钥) ⇒ semgrep(SAST) ⇒ trivy(依赖漏洞) │
│ E3 高危修复确认 (用户) │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ F: 交付 │
│ │
│ F1 交付包打包 │
│ F2 Checkpoint 标记 (git tag pipeline/cp-F-1) │
│ F3 删除 pipeline 锁 │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────┐
│ ✅ 超级1号 完成 │
│ 交付包 + 产出汇总 │
└─────────────────────┘
9把这个工作流技能命名为“超级1号团队”，分别3个量级，轻量，中量，重量来跑不同大小的项目，并且把第一个版本为1.0
💡A 阶段: 需求 + 架构
步骤 名称 执行者 说明 A0 环境预检 🤖 precheck-stage.sh A + schema 校验 A0.1 产品愿景 🧑💼 按模板: 做什么/目标用户/核心功能/约束 A0.2 领域语言对齐 🧑💼🤖 Skill(grill-with-docs) ⇒ CONTEXT.md + 按需 ADR A1 创建 PRD 🤖 Skill(bmad-create-prd), 按 feature 划分, 每 feature: 边界/验收标准/领域归属 A1.5 审查确认 PRD 🧑💼 必须 A2 输出 SDD 🤖 Skill(bmad-create-architecture), 架构模式/数据库/API风格 ⇒ ADR A2.5 确认技术栈与 Schema 🧑💼 必须, 结合 A3 评审意见 A2.6 数据库设计 🤖 输入 PRD+SDD+技术栈 ⇒ docs/database.md (ERD/表结构/查询路径/迁移策略) A2.7 后端详细设计 🤖 输入 SDD+database.md+API契约 ⇒ docs/backend-design.md (模块/中间件/缓存/部署) A3 架构审核 🤖 engineering-software-architect.md ⇒ subagent, 对照 ADR 检查决策
A 阶段产出: docs/prd.md docs/sdd.md docs/database.md docs/backend-design.md docs/architecture-review.md CONTEXT.md docs/decisions/
A-lightweight (简化版, --depth lightweight)
步骤 说明 A-L0 预检 A-L1 快速需求 (精简模板) A-L1.5 快速术语对齐 A-L2 精简 SDD
·············································································································································································································
💡B 阶段: UI/UX 原型 + API 契约
B0: 环境预检 ⇒ B0.5 原型检查 ⇒ 三分支
分支 条件 流程 B-P 有原型 B-P1 读取原型 ⇒ B-P2 提取 tokens ⇒ B-P3 组件规范 ⇒ B-P4 交互细节 ⇒ B-P5 确认 B-F 无原型 B-F1 UX 规范 ⇒ B-F1.5 确认方向 ⇒ B-F2 UI 设计执行 B-H 部分有 1. B-P 读已有 2. 识别缺失 3. B-F 补充缺失 4. 合并输出
B2: API 契约设计 (等 A2 和 B 都完成后)
步骤 说明 B2.1 读取 UX 产出 + DB 模型 B2.2 定义接口列表 (method/path/req/resp/状态码) B2.3 错误码定义 (业务码 + HTTP 映射) B2.4 WebSocket/SSE 定义 (如有) B2.5 确认 API 契约 🧑💼 必须
B 阶段产出: docs/design-tokens.md docs/component-spec.md docs/ux-spec.md docs/api-contract.md
·············································································································································································································
💡C 阶段: 开发实现
4 种深度模式
模式 适用场景 standard 全栈 Web App lightweight ≤5 task 小项目 mini-program 小程序 + 后端 native-app 原生 APP + 后端
C 阶段流程
步骤 名称 说明 C-p 入口预检 schema 校验 C0.1 读取输入 PRD + SDD + API契约 + 设计规范 C0.2 按 feature 切 task 从 PRD 提取 feature 列表 ⇒ 拆为独立 task C0.3 领域匹配 逐 task 匹配领域 (Backend/Frontend/Database/...) C0.3-b CodeGraph 验证 符号依赖验证, 自动发现隐式耦合 C0.4 依赖图构建 拓扑排序 ⇒ 确定 stage 执行顺序 C0.5 契约协议 docs/contracts/ 写入 C0.6 Scope 锁定 lock-scope.yaml C0.7 生成执行计划 stage plan 输出 C1 用户审查切片 🧑💼 确认依赖图 + task 划分 C2 逐 task 开发 dispatch subagent + domain expert + codegraph 符号上下文注入 C3 Git worktree 隔离 Skill(using-git-worktrees) C4 集成 + 烟雾测试 Stage Gate merge C5 契约健康检查 stale/orphaned 自修 C6 故障分级处理 见下方详细表 C7 用户回答 deferred 🧑💼 确认
Superpowers 主循环 (每 task)
writing-plans ⇒ worktree ⇒ TDD(红绿)
⇒ 实现 ⇒ [FAIL? systematic-debugging]
⇒ simplify ⇒ verification-before-completion
⇒ request-code-review ⇒ receive-code-review
⇒ handoff
C6 故障分级处理 (8 类)
类型 自动处理 重试上限 人介入? COMPILE_ERROR systematic-debugging 3 超限 ⇒ deferred TEST_FAILURE (单元) systematic-debugging 3 超限 ⇒ deferred TEST_FAILURE (集成) 回退 worktree, 不阻塞 gate 1 deferred TIMEOUT 停 agent ⇒ 重 dispatch 2 超限 ⇒ deferred DESIGN_FLAW 换 expert agent 1 分歧 ⇒ deferred OVER_ENGINEERING simplify 覆盖 0 不介入 SPEC_MISS 标记 deferred — 批量问 BLOCKED (外部) 标记 deferred — 批量问
·············································································································································································································
💡D 阶段: 质量门禁
组 内容 D1 lint 组 ESLint / 类型检查 / 格式检查 D2 test 组 单元测试 / 集成测试 / 烟雾测试 D3 专项审查组 集成测试 / E2E / codegraph_impact 影响域 / 性能基准
步骤 说明 D4 三组合并报告 D5 架构评审 (bmad-code-review - Blind Hunter) D6 契约校验 (codegraph_search 符号匹配) D7 Scope 越界检查 (lock-scope.yaml) D7.5 用户确认放行 🧑💼 必须
反馈回路 (最多 3 轮)
轮次 处理 Loop 1 自动修复 Loop 2 自动修复 + 日志 Loop 3 用户确认方向后修复 🧑💼 超限 继续 / 部分放行 / 人工接管 / 终止
·············································································································································································································
💡E 阶段: 安全扫描
触发:
config开启 /--security/ 涉及敏感数据
步骤 工具 说明 E1 git diff 判定扫描范围 (只扫改动) E2 gitleaks / semgrep / trivy 增量扫描: 密钥泄露 / SAST / 依赖漏洞 E3 - 高危修复确认 🧑💼
·············································································································································································································
💡F 阶段: 交付
步骤 说明 F1 交付包打包 F2 Checkpoint 标记 (git tag pipeline/cp-F-1) F3 删除 pipeline 锁
·············································································································································································································
Agent 生命周期 (8 态)
┌──────────┐
│ pending │ ← C0 产出切片
└────┬─────┘
┌────▼─────┐
│ queued │ ← 依赖满足但并发槽满
└────┬─────┘
┌────▼─────┐
│ running │ ← dispatch sub-agent
└────┬─────┘
┌──────────┼──────────┐
┌─────▼─────┐ ┌─▼──────┐ ┌─▼───────┐
│ done │ │ failed │ │ blocked │ ← failed 可重试
└─────┬─────┘ └──┬─────┘ └──┬───────┘
│ │ │
│ pending(重试) running(解除)
│ │
┌─────▼─────┐ │
│ merged │ ←─┘ ← Stage Gate 后
└───────────┘
·············································································································································································································
关键机制
机制 说明 Checkpoint 每 Stage Gate [PASS] ⇒ git tag pipeline/cp-<stage>-<n> + manifest --resume 从最近 checkpoint 恢复, 漂移自动回滚 Scope 锁定 C0.6 写 lock-scope.yaml, D7 检查越界 Stage Gate 每阶段串行 merge + 集成烟雾 + 失败隔离 handoff context >60% 自动生成交接文档 /clear 恢复 读 .planning/.active_plan ⇒ 三文件 ⇒ 从中断继续
·············································································································································································································
🥇启动命令
命令 用途 /pipeline 全流程 standard /pipeline --resume 从 checkpoint 恢复 /pipeline --stage A 只跑需求 /pipeline --stage D 只跑质量门 /pipeline --skip E 跳过安全 /pipeline --depth lightweight 小项目精简 /pipeline --dry-run 预览不执行
·············································································································································································································
🥇完整产出文件
docs/
├── prd.md # 产品需求 (A1)
├── sdd.md # 技术设计 (A2)
├── database.md # 数据库设计 (A2.6)
├── backend-design.md # 后端详细设计 (A2.7)
├── architecture-review.md # 架构评审 (A3)
├── design-tokens.md # 设计 token (B-P)
├── component-spec.md # 组件规范 (B-P)
├── ux-spec.md # UX 规范 (B-F)
├── api-contract.md # API 契约 (B2)
├── decisions/
│ └── D-*.md # ADR 决策记录
├── contracts/
│ └── *.schema.md # 契约文件 (C0.5)
└── CONTEXT.md # 术语词典 (A0.2)
