Workflow Lifecycle

Workflow Lifecycle

从用户模糊想法到上线后效果验证，一共 13 个节点。这是 AppGenesisForge 的核心交付链路。

完整鸟瞰图见 docs/product-workflow.md；本文做"step-by-step 怎么用"详解。

---

全景

USER → 1.想法 → 2.澄清 → 3.PRD → 4.计划 → 5.派任务 →
       6.实现 → 7.完成报告 → 8.code review → 9.SIT →
       10.E2E → 11.UAT → 12.release notes → 13.实验

主链路 1-11 是强制阶段门；12-13 是post-launch 可选。

---

节点 1-2：用户想法 → 澄清

输入：任意模糊形式（一句话 / 截图 / 草图）

动作：

/agf-team-start 我想做一个支持 OAuth 登录的用户认证模块

或

请启动 agf-product-lead，我有个模糊想法：[描述]

PL 内部：

1. 判断需求是否模糊 / 多选项 / 跨角色
2. 若是 → 必先调用 Skill({skill: "superpowers:brainstorming"})
3. 收敛 MVP 范围 + 识别开放问题（每条标 Owner）

输出：澄清后的需求骨架（暂未持久化）

---

节点 3：PRD

强制：分配任务前必须先创建 PRD 文件，否则不允许进入节点 5。

路径：docs/prd/[feature]-YYYY-MM-DD.md

模板：docs/prd/_TEMPLATE.md，10 节结构：

§	内容
1	Background — 为什么做、痛点
2	Goal & Non-Goals — 目标 + KPI + 显式不做
3	User Stories 表 — US-N ID
4	Acceptance Criteria 表 — AC-N + 优先级 P0/P1 + Verification
5	Design — UI 引用 + API 契约 + 数据模型
6	Technical Constraints
7	Cost Estimate — LLM token + cost-budget 档位
8	Out of Scope / Future Work
9	Open Questions — 每条标 Owner
10	Sign-offs — 各角色 checkbox

AC 可测试性硬要求：

• 必须有触发条件（"当…时"）
• 必须有可观察结果（"显示…"/"返回…"/"跳转至…"）
• ≤ 30s curl 或人工可验证
• ❌ 拒绝模糊描述："体验流畅"、"性能良好"

---

节点 4：实施计划

触发条件：PRD 涉及多步 / 跨角色 / ≥ 3 AC → PL 必先调用 Skill({skill: "superpowers:writing-plans"})

输出：实施计划（暂未持久化，但内部用于派任务）

跳过条件：单角色 / 单 AC 任务可直接进节点 5。

---

节点 5：Task 任务单

关键规则：任务消息必须摘录 AC 原文，不可只引用 PRD 路径（teammate 不继承会话上下文）。

五要素（缺一不可）：

SendMessage({to: "agf-frontend-dev", message: "
工程任务: 登录表单
任务类型: 新功能       ← 决定开发者是否触发 superpowers:test-driven-development
上下文:
  - 技术栈: 见 CLAUDE.md ## Tech Stack
  - 设计规范: docs/design/login/spec.md
  - API 契约: 与 agf-backend-dev 确认 POST /api/auth/login
  - 相关文件: src/components/

验收标准（完成后逐条自验再报告）:
- [ ] AC-1: 邮箱格式错误时...
- [ ] AC-2: 提交后按钮 loading 态...

PRD: docs/prd/login-2026-04-24.md
", summary: "前端任务: 登录表单"})

并行派发 ≥ 2 执行层 teammate 时强制 worktree 隔离——见 .claude/standards/workflow.md Parallel Dispatch。

---

节点 6：实现 + Unit 测试

执行层（frontend / backend / ai / ml / miniapp / uiux）实现并 AC 自验。

铁律：

• 收到"新功能" / "bugfix" → 必先调用 Skill({skill: "superpowers:test-driven-development"})
• 高风险操作（schema 迁移 / 认证改动 / LLM 厂商切换） → 必先 Plan Mode 拿授权
• 完成前 → 必先调用 Skill({skill: "superpowers:verification-before-completion"})

---

节点 7：完成报告

格式（开发者 → PL）：

SendMessage({to: "agf-product-lead", message: "
完成: 登录表单
任务类型: 新功能
Skills used: superpowers:test-driven-development, superpowers:verification-before-completion

AC 自验结果:
- [x] AC-1: ✅ 邮箱格式校验已验证
- [ ] AC-4: ⚠️ 跳转延迟约 420ms，超出 300ms 目标

文件: src/components/LoginForm.tsx
Unit 测试: src/components/LoginForm.test.tsx
", summary: "完成: 登录表单"})

有 AC 未达标时如实标注 ⚠️，不隐藏。PL 决定打回还是接受偏差。

---

节点 8：Code Review

PL 触发：

SendMessage({to: "agf-code-reviewer", message: "请审查 [功能名] 实现\n范围: [文件列表]\n参考: docs/prd/[file]"})

输出：docs/reviews/[feature]-YYYY-MM-DD.md，verdict 三档：

Verdict	含义	下一步
approve	无 critical 无 warning	进入 SIT
approve with changes	warning 可后续修但不阻塞	进入 SIT
request changes	有 critical 必修	PL 重派开发者修复

---

节点 9：SIT（系统集成测试）

门槛：code review verdict ∈ {approve, approve with changes}

操作：

1. 启动后端 + 数据库（真实，不 mock）
2. 针对真实 API 编写测试，覆盖正常 / 错误 / 边界
3. 验证数据库状态变更
4. 每条 AC 5 段齐：Setup / Action / Expected / Actual / Verdict

AI 产品专项：LLM 输出稳定性（同一输入 3 次）+ P95 延迟 + 降级行为

详见 skill agf-running-sit-tests + 报告 skill agf-writing-sit-report。

触发：/agf-sit <feature> 或 PL 手动派给 agf-qa-engineer

---

节点 10：E2E（端到端）

门槛：SIT pass

操作：

1. 前后端服务全部启动
2. 用 chrome-devtools-mcp 控制浏览器执行用户流程
3. 关键节点截图，对照 docs/design/[feature]/spec.md 与 index.html
4. 覆盖主流程 + 至少 2 个异常流程

小程序：用微信官方 miniprogram-automator + Jest，真机扫码（iOS + Android 各 1 台）。

---

节点 11：UAT + PL 业务签字

门槛：E2E pass

操作：

1. agf-qa-engineer 读 PRD §4 AC 表
2. 逐条执行 AC 对应测试场景（E2E 脚本 + 人工确认）
3. 写报告 docs/qa/[feature]-uat-YYYY-MM-DD.md
4. 提交报告给 PL

PL 业务签字（唯一签字角色）：

• 对照 PRD §4 AC 逐条确认
• 三档：approve / approve with changes / request changes
• 通过后向用户汇报：完成了什么 / 验收结果 / 已知限制

触发：/agf-uat <feature>

---

节点 12-13：Post-Launch（可选）

UAT 签字后，可选触发：

12. Release Notes

SendMessage({to: "agf-content-writer", message: "请为 [feature] 起草 release notes\nPRD: ...\nSIT: ..."})

24h 内交草稿到 docs/content/release-notes/YYYY-MM-DD-[slug].md。

13. 上线后实验

SendMessage({to: "agf-growth-analyst", message: "请设计 [feature] 上线后效果验证实验\n北极星候选: ...\nCounter Metric: ..."})

上线前定指标 + 上线后 7-14d 出实验报告。

---

失败回路

任一阶段失败：

   FAIL → agf-product-lead → 重新分派执行层修复 → 回到节点 6

禁止：跳过门槛 / agf-code-reviewer 直接改源码 / 跳过 PL 自行签字

---

完整 worked example

参考 examples/login-feature/：

文件	节点
00-prd.md	节点 3
01-adr-007-tanstack-query.md	tech-lead 介入
02-design-spec.md	uiux-designer
03-review-report.md	节点 8
04-sit-report.md	节点 9
05-uat-signoff.md	节点 11
06-release-notes.md	节点 12
07-experiment-followup.md	节点 13