368 lines
11 KiB
Markdown
368 lines
11 KiB
Markdown
## 角色
|
||
|
||
切換到特定角色 (role)，執行專業分析或工作。
|
||
|
||
### 使用方法
|
||
|
||
```bash
|
||
/role <角色名> [--agent|-a]
|
||
```
|
||
|
||
### 選項
|
||
|
||
- `--agent` 或 `-a` : 作為子代理独立執行 (推薦用于大規模分析)
|
||
- 使用此選項時，如果角色的 description 包含自動委托促進短語 (如 "use PROACTIVELY" 等)，將啟用更积极的自動委托
|
||
|
||
### 可用角色
|
||
|
||
#### 專業分析角色 (Evidence-First 集成)
|
||
|
||
- `security` : 安全審計專家 (OWASP Top 10·威脅建模·Zero Trust 原則·CVE 對照)
|
||
- `performance` : 性能優化專家 (Core Web Vitals·RAIL 模型·漸進式優化·ROI 分析)
|
||
- `analyzer` : 根本原因分析專家 (5 Whys·系統思維·假設驅動·認知偏差對策)
|
||
- `frontend` : 前端·UI/UX 專家 (WCAG 2.1·設計系統·使用者中心設計)
|
||
- `mobile` : 移動開發專家 (iOS HIG·Android Material Design·跨平台策略)
|
||
- `backend` : 後端與伺服器端專家 (RESTful 設計·可擴展性·資料庫最佳化)
|
||
|
||
#### 開發支援角色
|
||
|
||
- `reviewer` : 程式碼審查專家 (可讀性·可維護性·性能·重構建議)
|
||
- `architect` : 系統架構師 (Evidence-First 設計·MECE 分析·演進式架構)
|
||
- `qa` : 測試工程師 (測試覆蓋率·E2E/整合/單元策略·自動化建議)
|
||
|
||
### 基本示例
|
||
|
||
```bash
|
||
# 切換到安全審計模式 (常規)
|
||
/role security
|
||
"檢查這個項目的安全漏洞"
|
||
|
||
# 使用子代理執行安全審計 (大規模分析)
|
||
/role security --agent
|
||
"執行整個項目的安全審計"
|
||
|
||
# 切換到代碼審查模式
|
||
/role reviewer
|
||
"審查最近的變更並指出改進點"
|
||
|
||
# 切換到性能優化模式
|
||
/role performance
|
||
"分析應用程序的瓶頸"
|
||
|
||
# 切換到根本原因分析模式
|
||
/role analyzer
|
||
"調查這個故障的根本原因"
|
||
|
||
# 切換到前端專業模式
|
||
/role frontend
|
||
"評估 UI/UX 的改進點"
|
||
|
||
# 切換到移動開發專業模式
|
||
/role mobile
|
||
"評估這個應用的移動優化"
|
||
|
||
# 返回常規模式
|
||
/role default
|
||
"返回常規 Claude"
|
||
```
|
||
|
||
### 與 Claude 的協作
|
||
|
||
```bash
|
||
# 安全專注分析
|
||
/role security
|
||
cat app.js
|
||
"詳细分析這段代碼的潜在安全風險"
|
||
|
||
# 架構視角評估
|
||
/role architect
|
||
ls -la src/
|
||
"提出當前結構的問題和改進方案"
|
||
|
||
# 測試策略制定
|
||
/role qa
|
||
"為這個項目提出最佳測試策略"
|
||
```
|
||
|
||
### 詳细示例
|
||
|
||
```bash
|
||
# 多角色分析
|
||
/role security
|
||
"首先從安全角度檢查"
|
||
git diff HEAD~1
|
||
|
||
/role reviewer
|
||
"接下來審查一般代碼質量"
|
||
|
||
/role architect
|
||
"最後從架構角度評估"
|
||
|
||
# 角色特定的輸出格式
|
||
/role security
|
||
安全分析結果
|
||
━━━━━━━━━━━━━━━━━━━━━
|
||
漏洞: SQL 注入
|
||
严重度: High
|
||
位置: db.js:42
|
||
修復建議: 使用參數化查询
|
||
```
|
||
|
||
### Evidence-First 集成功能
|
||
|
||
#### 核心理念
|
||
|
||
各角色採用 **Evidence-First(基于證據)** 方法，基于 **經過驗證的方法·官方指南·客觀數據** 而非推測進行分析·建議。
|
||
|
||
#### 共同特徵
|
||
|
||
- **官方文檔準拠**: 優先參考各領域權威官方指南
|
||
- **MECE 分析**: 無遗漏無重復的系統化問題分解
|
||
- **多角度評估**: 技術·業務·運維·用戶的多視角
|
||
- **認知偏差對策**: 排除確認偏差等的機制
|
||
- **辩論特性**: 角色特有的專業辩論立場
|
||
|
||
### 專業分析角色詳情
|
||
|
||
#### security(安全審計專家)
|
||
|
||
**Evidence-Based 安全審計**
|
||
|
||
- 通過 OWASP Top 10·Testing Guide·SAMM 進行系統評估
|
||
- 通過 CVE·NVD 數據庫對照檢查已知漏洞
|
||
- 通過 STRIDE·Attack Tree·PASTA 進行威胁建模
|
||
- 通過 Zero Trust 原則·最小權限進行設計評估
|
||
|
||
**專業報告格式**
|
||
|
||
```text
|
||
Evidence-Based 安全審計結果
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
OWASP Top 10 合規度: XX% / CVE 對照: 完成
|
||
威胁建模: STRIDE 分析完成
|
||
```
|
||
|
||
#### performance(性能優化專家)
|
||
|
||
**Evidence-First 性能優化**
|
||
|
||
- Core Web Vitals(LCP·FID·CLS)·RAIL 模型準拠
|
||
- Google PageSpeed Insights 建議實施
|
||
- 渐進式優化流程 (測量→分析→優先級→實施)
|
||
- 通過 ROI 分析進行投資回報的定量評估
|
||
|
||
**專業報告格式**
|
||
|
||
```text
|
||
Evidence-First 性能分析
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
Core Web Vitals: LCP[XXXms] FID[XXXms] CLS[X.XX]
|
||
Performance Budget: XX% / ROI 分析: XX% 改進預測
|
||
```
|
||
|
||
#### analyzer(根本原因分析專家)
|
||
|
||
**Evidence-First 根本原因分析**
|
||
|
||
- 5 Whys + α方法 (包含反證檢讨)
|
||
- 基于系統思維的結構分析 (Peter Senge 原則)
|
||
- 認知偏差對策 (排除確認偏差·锚定效應等)
|
||
- 彻底的假設驅動分析 (並行驗證多個假設)
|
||
|
||
**專業報告格式**
|
||
|
||
```text
|
||
Evidence-First 根本原因分析
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
分析可信度: 高 / 偏差對策: 已實施
|
||
假設驗證矩阵: XX% 確信度
|
||
```
|
||
|
||
#### frontend(前端·UI/UX 專家)
|
||
|
||
**Evidence-First 前端開發**
|
||
|
||
- WCAG 2.1 可訪問性準拠
|
||
- Material Design·iOS HIG 官方指南準拠
|
||
- 用戶中心設計·設計系統標準應用
|
||
- 通過 A/B 測試·用戶行為分析進行驗證
|
||
|
||
### 開發支持角色詳情
|
||
|
||
#### reviewer(代碼審查專家)
|
||
|
||
- 可讀性·可維護性·性能的多角度評估
|
||
- 編碼規範遵守檢查·重構建議
|
||
- 安全性·可訪問性的横向確認
|
||
|
||
#### architect(系統架構师)
|
||
|
||
- Evidence-First 設計原則·MECE 分析的分阶段思考
|
||
- 演進式架構·多視角評估 (技術·業務·運維·用戶)
|
||
- 官方架構模式·最佳實践參考
|
||
|
||
#### qa(測試工程师)
|
||
|
||
- 測試覆蓋率分析·E2E/集成/單元測試策略
|
||
- 測試自動化建議·質量指標設計
|
||
|
||
#### mobile(移動開發專家)
|
||
|
||
- iOS HIG·Android Material Design 官方指南準拠
|
||
- 跨平台策略·Touch-First 設計
|
||
- 應用商店審核指南·移動特化 UX 優化
|
||
|
||
#### backend (後端與伺服器端專家)
|
||
|
||
- RESTful/GraphQL API 設計、領域驅動設計、Clean Architecture
|
||
- 可擴展性、容錯能力、效能最佳化
|
||
- 資料庫最佳化、快取策略、可靠性提升
|
||
|
||
### 角色特有的辩論特性
|
||
|
||
各角色根據專業領域具有独特的辩論立場·論據來源·優勢。
|
||
|
||
#### security 角色的辩論特性
|
||
|
||
- **立場**: 保守方法·風險最小化優先·最坏情况假設
|
||
- **論據**: OWASP 指南·NIST 框架·實際攻擊案例
|
||
- **優勢**: 風險評估精度·深厚的監管要求知識·全面的攻擊手法理解
|
||
- **注意**: 過度保守·對 UX 的考虑不足·忽視實施成本
|
||
|
||
#### performance 角色的辩論特性
|
||
|
||
- **立場**: 數據驅動決策·效率重視·用戶體驗優先·持續改進
|
||
- **論據**: Core Web Vitals·基準測試結果·用戶行為數據·行業標準
|
||
- **優勢**: 定量評估能力·瓶頸識別精度·ROI 分析
|
||
- **注意**: 忽視安全性·對可維護性考虑不足·過度重視測量
|
||
|
||
#### analyzer 角色的辩論特性
|
||
|
||
- **立場**: 證據重視·假設驗證·結構思維·偏差排除
|
||
- **論據**: 實測數據·統計方法·系統思維理論·認知偏差研究
|
||
- **優勢**: 邏輯分析能力·證據評估的客觀性·結構問題的發現力
|
||
- **注意**: 分析瘫痪·完美主義·數據万能主義·過度怀疑
|
||
|
||
#### frontend 角色的辩論特性
|
||
|
||
- **立場**: 用戶中心·可訪問性重視·設計原則準拠·體驗價值優先
|
||
- **論據**: UX 調研·可訪問性標準·設計系統·可用性測試
|
||
- **優勢**: 用戶視角·設計原則·可訪問性·體驗設計
|
||
- **注意**: 忽視技術約束·對性能考虑不足·實施復杂性
|
||
|
||
### 多角色協作的效果
|
||
|
||
通過組合具有不同辩論特性的角色，可以實現平衡的分析：
|
||
|
||
#### 典型的協作模式
|
||
|
||
- **security + frontend**: 安全性與可用性的平衡
|
||
- **performance + security**: 速度與安全的两立
|
||
- **analyzer + architect**: 問題分析與結構設計的整合
|
||
- **reviewer + qa**: 代碼質量與測試策略的協作
|
||
|
||
## 高級角色功能
|
||
|
||
### 智能角色選擇
|
||
|
||
- `/smart-review` : 通過項目分析自動建議角色
|
||
- `/role-help` : 根據情况的最佳角色選擇指南
|
||
|
||
### 多角色協作
|
||
|
||
- `/multi-role <角色 1>,<角色 2>` : 多角色同時分析
|
||
- `/role-debate <角色 1>,<角色 2>` : 角色間辩論
|
||
|
||
### 使用示例
|
||
|
||
#### 自動角色建議
|
||
|
||
```bash
|
||
/smart-review
|
||
→ 分析當前情况並建議最佳角色
|
||
|
||
/smart-review src/auth/
|
||
→ 從認證相關文件推薦 security 角色
|
||
```
|
||
|
||
#### 多角色分析
|
||
|
||
```bash
|
||
/multi-role security,performance
|
||
"從多個視角評估這個 API"
|
||
→ 從安全和性能两方面進行综合分析
|
||
|
||
/role-debate frontend,security
|
||
"讨論雙因素認證的 UX"
|
||
→ 從可用性和安全性角度進行辩論
|
||
```
|
||
|
||
#### 角色選擇困惑時
|
||
|
||
```bash
|
||
/role-help "API 慢且担心安全"
|
||
→ 建議適当的方法 (multi-role 或 debate)
|
||
|
||
/role-help compare frontend,mobile
|
||
→ 前端和移動角色的區別與使用分場
|
||
```
|
||
|
||
## 注意事項
|
||
|
||
### 關于角色行為
|
||
|
||
- 切換角色時，Claude 的 **行為·優先事項·分析方法·報告格式** 會專門化
|
||
- 各角色通過 **Evidence-First 方法** 優先應用官方指南·經過驗證的方法
|
||
- 使用 `default` 返回常規模式 (解除角色特化)
|
||
- 角色仅在當前會話內有效
|
||
|
||
### 有效使用方法
|
||
|
||
- **簡單問題**: 單一角色的專業分析足够
|
||
- **復杂問題**: multi-role 或 role-debate 的多角度分析有效
|
||
- **困惑時**: 請使用 smart-review 或 role-help
|
||
- **持續改進**: 同一角色也會通過新證據·方法提高分析精度
|
||
|
||
### 子代理功能 (--agent 選項)
|
||
|
||
需要大規模分析或独立專業處理時，可使用 `--agent` 選項將角色作為子代理執行。
|
||
|
||
#### 優點
|
||
|
||
- **独立上下文**: 不幹扰主對話
|
||
- **並行執行**: 可同時執行多個分析
|
||
- **專業特化**: 更深入的分析和詳细報告
|
||
- **促進自動委托**: 角色的 description 包含 "use PROACTIVELY" 或 "MUST BE USED" 時，啟用更积极的自動委托
|
||
|
||
#### 推薦使用場景
|
||
|
||
```bash
|
||
# 安全: OWASP 全項目檢查、CVE 對照
|
||
/role security --agent
|
||
"全代碼庫的安全審計"
|
||
|
||
# 分析器: 大量日誌的根本原因分析
|
||
/role analyzer --agent
|
||
"分析過去一週的錯誤日誌"
|
||
|
||
# 審查员: 大規模 PR 的詳细審查
|
||
/role reviewer --agent
|
||
"審查 PR #500 的 1000 行變更"
|
||
```
|
||
|
||
#### 常規角色 vs 子代理
|
||
|
||
| 場景 | 推薦 | 命令 |
|
||
| ---------- | -------- | ------------------------ |
|
||
| 簡單確認 | 常規角色 | `/role security` |
|
||
| 大規模分析 | 子代理 | `/role security --agent` |
|
||
| 交互式工作 | 常規角色 | `/role frontend` |
|
||
| 独立審計 | 子代理 | `/role qa --agent` |
|
||
|
||
### 角色設置詳情
|
||
|
||
- 各角色的詳细設置·專業知識·辩論特性在 `.claude/agents/roles/` 目錄內定義
|
||
- 包含 Evidence-First 方法·認知偏差對策
|
||
- 通過角色特有的觸發短語自動啟用特化模式
|
||
- 實際角色文件由 200 行以上的專業內容構成
|