multi-role-reviewlisted
Install: claude install-skill AliceLJY/workflow-orchestrator
# Multi-Role Plan Review
Plan 写完了?在动手之前,让 4 个不同视角的"审查员"同时过一遍。每个人只关注自己的维度,最后交叉对照发现盲区。
**设计哲学**:复用 content-alchemy Stage 4 的"三方质询"模式——不是修修补补,而是让不同立场**互相挑战**,暴露单一视角看不到的问题。
## 什么时候用
- `superpowers:writing-plans` 产出 plan 之后、开始执行之前
- 用户说"帮我审一下这个计划"
- 编排层自动判断需要审查时
## 4 个审查角色
| 角色 | 英文代号 | 核心问题 | 审什么 |
|------|---------|---------|--------|
| 用户代言人 | User Advocate | 这真的解决了用户的问题吗? | 需求覆盖、过度工程、用户体验 |
| 架构师 | Architect | 设计干净吗?边界对吗? | 模块划分、接口设计、可扩展性、技术选型 |
| 风险猎人 | Risk Hunter | 什么会出错? | 安全隐患、边界情况、依赖风险、故障模式 |
| 务实主义者 | Pragmatist | 有更简单的方式吗? | YAGNI 违规、不必要的复杂度、实现成本 |
> 这 4 个角色借鉴了 content-alchemy 的乐观/悲观/人文三方质询,但针对代码场景重新设计。
> 核心不变:**每个角色必须指出其他角色的盲区**。
## 执行流程
```
Plan 文件就绪
↓
读取 plan 内容 + 项目上下文
↓
并行 dispatch 4 个子 agent(各自独立上下文)
↓
收集 4 份审查结果
↓
交叉盲区分析 + 核心张力提取
↓
生成精炼审查报告
↓
呈现给用户,等待决策
```
## 如何执行
### Step 1: 准备上下文
```bash
# 读取 plan 文件
PLAN_PATH="<plan 文件路径>"
# 读取项目结构概要(如有)
PROJECT_CONTEXT="<项目关键文件/架构说明>"
```
### Step 2: 并行 dispatch 4 个子 agent
使用 `superpowers:dispatching-parallel-agents` 模式,每个 agent 获得:
- Plan 完整内容
- 项目上下文(仅相关部分)
- 角色指令(见下方模板)
- 明确的输出格式要求
**关键:每个 agent 获得精准构造的上下文,不继承主会话历史。**
#### Agent 1: User Advocate(用户代言人)
```markdown
你是"用户代言人"。你的工作是站在最终用户的角度审查这个实现计划。
审查维度:
1. 需求覆盖:plan 是否完整覆盖了用户需要解决的问题?有遗漏吗?
2. 过度工程:有没有用户根本不需要的功能被塞进来了?
3. 用户体验:交互流程自然吗?用户需要学习新概念吗?
4. 优先级:最影响用户的功能是否在前面?
输出格式(严格遵守):
## User Advocate Review
**通过项 ✅**: [列出做得好的 1-3 点]
**关注项 ⚠️**: [列出 0-3 个问题,每个一句话说清]
**盲区提示 🔍**: [其他角色可能忽略的 1 个用户视角问题]
**一句话结论**: [Go / Go with concerns /