/multi-role

多角色分析

使用多个角色并行分析同一对象，生成综合报告的命令。

使用方法

/multi-role <角色 1>,<角色 2> [--agent|-a] [分析对象]
/multi-role <角色 1>,<角色 2>,<角色 3> [--agent|-a] [分析对象]

可用角色

专业分析角色

• security : 安全审计专家
• performance : 性能优化专家
• analyzer : 根本原因分析专家
• frontend : 前端·UI/UX 专家
• mobile : 移动开发专家
• backend : 后端与服务器端专家

开发支持角色

• reviewer : 代码审查专家
• architect : 系统架构师
• qa : 测试工程师

重要:

• --agent 选项需要放在角色指定之后
• 消息要写在 --agent 之后
• 正确示例: /multi-role qa,architect --agent 评估计划
• 错误示例: /multi-role qa,architect 评估计划 --agent

选项

• --agent 或 -a : 将各角色作为子代理并行执行 (推荐用于大规模分析)
  • 使用此选项时，如果角色的 description 中包含自动委托促进短语 (如 "use PROACTIVELY" 等)，将启用更积极的自动委托

基本示例

# 安全和性能的双重分析 (常规)
/multi-role security,performance
"评估这个 API 端点"

# 大规模系统的并行分析 (子代理)
/multi-role security,performance --agent
"全面分析系统的安全性和性能"

# 前端·移动·性能的综合分析
/multi-role frontend,mobile,performance
"考虑这个界面的优化方案"

# 架构设计的多角度评估 (子代理)
/multi-role architect,security,performance --agent
"评估微服务化的设计"

分析流程

阶段 1: 并行分析

各角色独立分析同一对象

• 从专业视角进行评估
• 按角色特有标准判定
• 生成独立的建议

阶段 2: 综合分析

结构化整合结果

• 整理各角色的评估结果
• 识别重复·矛盾点
• 明确互补关系

阶段 3: 综合报告

生成最终建议

• 带优先级的行动计划
• 明示权衡取舍
• 提供实施路线图

输出格式示例

2 角色分析的情况

多角色分析: Security + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分析对象: API 端点 /api/users

Security 分析结果:
认证: JWT 验证实施得当
授权: 基于角色的访问控制不完整
加密: API 密钥在日志中以明文输出

评估分数: 65/100
重要度: High(因为访问敏感数据)

Performance 分析结果:
响应时间: 平均 180ms(目标 200ms 以内)
数据库查询: 检测到 N+1 问题
缓存: Redis 缓存未实施

评估分数: 70/100
重要度: Medium(目前在可接受范围内)

相互关联分析:
协同效应机会:
- 实施 Redis 缓存时同时考虑加密
- 改进日志输出提升安全性和性能

权衡点:
- 加强授权检查 ↔ 对响应时间的影响
- 日志加密 ↔ 调试效率降低

综合优先级:
Critical: 修复 API 密钥明文输出
High: 解决 N+1 查询
Medium: 实施 Redis 缓存 + 加密
Low: 细化授权控制

实施路线图:
第 1 周: 实施 API 密钥屏蔽
第 2 周: 优化数据库查询
第 3-4 周: 设计·实施缓存层
第 2 月: 逐步加强授权控制

3 角色分析的情况

多角色分析: Frontend + Mobile + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分析对象: 用户资料界面

Frontend 分析结果:
可用性: 直观的布局
可访问性: WCAG 2.1 符合率 85%
响应式: 平板显示有问题

Mobile 分析结果:
触摸目标: 确保 44pt 以上
单手操作: 重要按钮在上方
离线支持: 未实施

Performance 分析结果:
初始显示: LCP 2.1 秒 (良好)
图像优化: 不支持 WebP
延迟加载: 未实施

综合建议:
1. 移动优化 (单手操作 + 离线支持)
2. 图像优化 (WebP + 延迟加载)
3. 改进平板 UI

优先级: Mobile > Performance > Frontend
实施期间: 3-4 周

有效的组合模式

安全重视

/multi-role security,architect
"认证系统的设计"

/multi-role security,frontend
"登录界面的安全性"

/multi-role security,mobile
"移动应用的数据保护"

性能重视

/multi-role performance,architect
"可扩展性设计"

/multi-role performance,frontend
"Web 页面高速化"

/multi-role performance,mobile
"应用运行优化"

用户体验重视

/multi-role frontend,mobile
"跨平台 UI"

/multi-role frontend,performance
"UX 与性能的平衡"

/multi-role mobile,performance
"移动 UX 优化"

全面分析

/multi-role architect,security,performance
"系统整体评估"

/multi-role frontend,mobile,performance
"用户体验综合评估"

/multi-role security,performance,mobile
"移动应用综合诊断"

与 Claude 的协作

# 结合文件分析
cat src/components/UserProfile.tsx
/multi-role frontend,mobile
"从多个视角评估这个组件"

# 设计文档评估
cat architecture-design.md
/multi-role architect,security,performance
"从多个专业领域评估这个设计"

# 错误分析
cat performance-issues.log
/multi-role performance,analyzer
"多角度分析性能问题"

multi-role vs role-debate 的使用区分

使用 multi-role 的场合

• 需要各专业领域的独立评估
• 想制定综合改进计划
• 需要整理矛盾或重复
• 要决定实施优先级

使用 role-debate 的场合

• 专业领域间存在权衡
• 技术选型可能有分歧
• 想通过讨论决定设计方针
• 想听取不同视角的辩论

子代理并行执行 (--agent)

使用 --agent 选项时，各角色作为独立的子代理并行执行。

自动委托的促进

当角色文件的 description 字段包含以下短语时，使用 --agent 会启用更积极的自动委托：

• "use PROACTIVELY"
• "MUST BE USED"
• 其他强调表达

执行流程

常规执行:
角色 1 → 角色 2 → 角色 3 → 综合
(顺序执行，约 3-5 分钟)

--agent 执行:
角色 1 ─┐
角色 2 ─┼→ 综合
角色 3 ─┘
(并行执行，约 1-2 分钟)

有效使用示例

# 大规模系统的综合评估
/multi-role architect,security,performance,qa --agent
"新系统的全面评估"

# 多视角的详细分析
/multi-role frontend,mobile,performance --agent
"所有界面的 UX 优化分析"

性能比较

角色数	常规执行	--agent 执行	缩短率
2 角色	2-3 分钟	1 分钟	50%
3 角色	3-5 分钟	1-2 分钟	60%
4 角色	5-8 分钟	2-3 分钟	65%

注意事项

• 同时执行 3 个以上角色时输出会变长
• 复杂分析可能需要更长执行时间
• 出现相互矛盾的建议时，也可考虑 role-debate
• 最终判断请参考综合结果由用户决定
• 使用 --agent 时: 会使用更多资源，但对大规模分析更高效

角色配置详情

• 各角色的详细配置、专业知识与讨论特性都定义在 .claude/agents/roles/ 目录中
• 包含 Evidence-First 方法与认知偏差对策
• 角色专属触发短语会自动启用特化模式