XIJIAN DOCS

流程与团队优化方案 3.0

四缺陷诊断/旅程验收/团队定义修订（待用户裁决） · ← 返回文档中心

目录
1. 这次验收暴露的四个结构性缺陷（诊断）2. 团队定义 3.0 修订（已同步落入 .claude/agents/）3. 流程修订（dev-charter v1.4 要点）4. 对既有产出的处置（本方案生效后第一批动作）5. 待用户裁决

流程与团队优化方案 3.0

版本：v3.0 草案 ｜ 2026-08-17 ｜ 触发：P0 验收用户不满意（拆解/执行/团队三层都有问题） 定位：P1 开工前的流程重构——针对结构性缺陷，不是补丁清单

1. 这次验收暴露的四个结构性缺陷（诊断）

# 缺陷 实证 根因层
D1 没有角色对"用户旅程"负责 任务详情页断点：后台能建任务、卡片带 task_id 直开、但达人点开的详情页还是旧页——每个页面/接口各自验收通过，旅程断了没人发现，用户成了第一个走全程的人 拆解按页面/接口切分，验收判据里没有"旅程连贯"这一层
D2 性能是补救不是设计 274 秒 N+1 靠 qa 抓、tab 2.7 秒靠用户抓；api-tester 只有功能维度 开发单无性能预算，测试角色无性能职责
D3 体验环境无状态说明 用户被新旧后端并存的登录残留误导，无法判断"看到的数据来自哪个系统" 交付即甩给用户，缺"体验前环境说明书"环节
D4 用户定案被执行方违反 "上线前才导生产数据"定案被主会话以"真机需要数据"为由绕过 定案没有登记核对机制，执行时靠记忆

2. 团队定义 3.0 修订（已同步落入 .claude/agents/）

成员 修订
qa-acceptor 新增第一职责：端到端旅程验收——每条验收必须先定义"用户旅程剧本"（达人：卡片→入驻→报名→履约→结算；运营：建任务→反选→确认→跟进），按剧本逐步走，旅程断点一律判 P0 级（哪怕每个单点都绿）；页面/接口级验收降为旅程的子项证据
product-owner 拆单规则重构：按旅程切竖片，不按页面/接口切横层——每个开发单的完成定义是"这段旅程可走通"，两端联动功能（后台配置↔达人端消费）强制同一批次交付，禁止一端先行落地造成断点
api-tester 性能维度已落（查询计数守护/响应预算/敏感路径标记）——本轮已执行
ux-reviewer 防错镜头之外新增旅程连贯性镜头：走查不只在单页内，要跨页走完整旅程（含跨端提示：此处该有小程序侧对应物吗？）
主会话（tech lead） 两条硬纪律入宪：① 体验前环境说明书——请用户实操前必须先交付一页说明（当前系统形态/哪些数据来自哪个库/新旧并存的边界/预期能走通什么、预期走不通什么）；② 用户定案登记核对——确认记录文件升级为执行前必查的"定案登记表"，任何与定案相关的操作先对表，绕过定案=事故

3. 流程修订（dev-charter v1.4 要点）

  1. 验收三层结构（替代原"页面+接口"两层）：接口契约（api-tester）→ 页面/域（qa 单点）→ 旅程（qa 端到端剧本，最高层，一票否决）
  2. 性能预算入开发单模板：列表类接口默认 <500ms（真库）、批量任务默认给量级预算——PO 拆单时必填，api-tester 按预算断言
  3. 两端同批交付原则：跨端功能（后台配置↔达人端消费↔消息台触达）在执行计划里合并为一个"旅程任务"，内部再分 a/b/c 段，段全清才标 ✅
  4. 体验交付协议：任何请用户实操的时点，先发环境说明书（模板三问：现在是什么形态/数据从哪来/什么能走通什么不能）
  5. 定案登记表：docs/business/sources/*confirmations*.md 每条定案带【执行状态】标记，主会话执行敏感操作（数据/生产/发布）前 grep 对表

4. 对既有产出的处置（本方案生效后第一批动作）

  1. P1 开工前先做一轮旅程盘点：把达人端与运营端各自的完整旅程画出来，标出现有断点（已知：任务详情页、报名入口引导、商单 tab 交互），断点清单直接生成 P1 旅程任务
  2. 终审 P1×8 修复波并入第一个旅程批次（不单独跑，避免"修完又是孤立单点"）
  3. UI 重设计（用户主导 Claude Design）产出后，P1 前端一律按新设计实现——旧页不再打磨

5. 待用户裁决