/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 手法與認知偏差對策
• 角色專屬觸發語句會自動啟用特化模式