SuperClaude v3.0.0.1 是一個革命性的 Claude Code 配置框架,將通用 AI 助手轉變為專業的企業級開發夥伴。該框架通過 16 個專業化命令、9 個認知角色和 70% 的 Token 優化,已為 6,500+ 開發者提供了結構化、高效的 AI 輔助開發解決方案。
從技術架構師的角度分析,SuperClaude 解決了企業級開發中的三大核心挑戰:AI 助手缺乏專業化、開發工作流程標準化困難,以及 Token 成本過高。通過證據驅動的方法論和模塊化設計,它為現代軟體開發提供了可擴展、可維護的 AI 輔助框架。
如果您是從 SuperClaude v2 升級,請注意以下關鍵變化:
- 徹底清理舊檔案:請手動刪除以下可能存在的文件和目錄,以避免衝突:
SuperClaude/
(舊的專案根目錄)~/.claude/shared/
~/.claude/commands/
~/.claude/CLAUDE.md
- 命令用途變更:
- 在 v2 中,
/build
用於功能實現。 - 在 v3 中,
/sc:build
用於編譯/打包專案。 - 新的命令
/sc:implement
用於功能實現。請將您現有的v2 /build myFeature
替換為v3 /sc:implement myFeature
。
- 在 v2 中,
- 簡介
- 核心技術架構
- 安裝與配置指南
- 核心概念
- 通用旗標 (Universal Flags)
- 認知角色深度解析
- 指令參考與完整指南
- SuperClaude 與軟體開發生命週期 (SDLC)
- 企業級應用場景
- 工作流程範例
- MCP 整合與工具生態
- 最佳實踐與優化策略
- 實際專案案例分析
- 常見問題與解決方案
- 進階配置與自訂化
- 未來發展與技術路線
- 結論:企業級價值與戰略意義
SuperClaude
是一個為 Claude Code
設計的強化設定框架。它透過一系列專門的指令、9 種認知角色(Personas)和專業開發方法論,將標準的 Claude Code
提升到一個新的層次,使其在處理複雜的軟體開發任務時更加精準、高效且專業。
- 模組化與可擴展性: 框架本身採用高度模組化的設定,易於維護和擴展。
- 實證基礎 (Evidence-Based): 強調所有分析和建議都應基於可查證的來源,例如引用文件或原始碼。
- Token 經濟學: 內建多種機制(如壓縮模式)來最佳化 Token 使用,以應對大型專案。
- 情境感知: 能夠在整個開發會話中保持上下文,進行連貫的深度分析。
- 專業分工: 透過「認知角色」,讓 AI 能夠模擬不同領域專家的思維模式來解決特定問題。
SuperClaude v3 採用簡潔、可靠、模組化且高性能的架構設計,基於 @include
引用系統實現模塊化配置管理。其核心架構包含四個層次:
配置層 (Configuration Layer)
├── CLAUDE.md # 主配置加載器
├── RULES.md # 10 級嚴重性操作規則
├── PERSONAS.md # 9 個認知角色定義
└── MCP.md # Model Context Protocol 整合
命令層 (Command Layer)
├── commands/ # 16 個專業化命令
│ ├── 開發類:implement, build, design
│ ├── 分析類:analyze, troubleshoot, explain
│ ├── 品質類:improve, test, cleanup
│ └── 其他:document, git, estimate, task, index, load, spawn
資源層 (Resource Layer)
├── shared/ # 19 個配置資源
│ ├── ambiguity-check.yml
│ ├── audit.yml
│ ├── checkpoint.yml
│ └── performance-monitoring.yml
工具層 (Tool Layer)
├── Context7 # 文檔研究工具
├── Sequential # 深度分析工具
├── Magic # UI 組件生成
└── Playwright # 瀏覽器自動化
簡潔性:v3 移除了不必要的複雜性,專注於核心價值。 可靠性:優化了安裝流程,減少了破壞性變更的可能性。 模組化:支援選擇性安裝組件,提高靈活性。 性能:透過更智能的緩存機制,提升了操作速度。
證據驅動開發:通過 RULES.md 實施基於證據的開發方法論,包含 CRITICAL [10] 級別的不可協商阻止器,確保代碼質量和安全性。
Token 經濟優化:UltraCompressed 模式實現 70% Token 使用減少,採用符號化語法(→ 表示「導致」,& 表示「和」)和智能模型路由。
Git 檢查點系統:允許開發者導航回工作流程中的任何點,支援會話感知和學習能力。
支援平台:Linux、macOS、Windows Subsystem for Linux (WSL) 必要軟體:Claude Code 4.0+、Git 配置 可選軟體:GitHub CLI、Node.js 18+
SuperClaude 的安裝是一個兩階段流程:
- 首先安裝 Python 套件
- 然後運行安裝器來設定 Claude Code 整合
選項 A: 從 PyPI 安裝 (推薦)
pip install SuperClaude
選項 B: 從源碼安裝
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
pip install .
SuperClaude v3 也支援透過 uv
(一個更快、現代的 Python 套件管理器) 或 uvx
進行跨平台安裝。
確保 uv
已安裝:
curl -Ls https://astral.sh/uv/install.sh | sh
或遵循此處的說明:https://github.com/astral-sh/uv
一旦 uv
可用,您可以這樣安裝 SuperClaude:
uv venv
source .venv/bin/activate
uv pip install SuperClaude
如果您正在使用 uvx
,只需運行:
uvx pip install SuperClaude
安裝套件後,繼續執行通常的安裝器步驟:
python3 -m SuperClaude install
或者使用 Bash 風格的 CLI:
SuperClaude install
uv
提供更好的緩存和效能。- 兼容 Python 3.8+,並與 SuperClaude 順暢運行。
缺少 Python 嗎? 請先安裝 Python 3.7+:
# Linux (Ubuntu/Debian)
sudo apt update && sudo apt install python3 python3-pip
# macOS
bres install python3
# Windows
# 從 https://python.org/downloads/ 下載
安裝套件後,運行 SuperClaude 安裝器來配置 Claude Code (您可以使用以下任何方法):
安裝 SuperClaude 後。您可以使用 SuperClaude commands
、python3 -m SuperClaude commands
或 python3 SuperClaude commands
# 快速設定 (推薦給大多數用戶)
python3 SuperClaude install
# 互動式選擇 (選擇組件)
python3 SuperClaude install --interactive
# 最小化安裝 (僅核心框架)
python3 SuperClaude install --minimal
# 開發者設定 (包含所有)
python3 SuperClaude install --profile developer
# 查看所有可用選項
python3 SuperClaude install --help
# 快速設定 (推薦給大多數用戶)
python3 -m SuperClaude install
# 互動式選擇 (選擇組件)
python3 -m SuperClaude install --interactive
# 最小化安裝 (僅核心框架)
python3 -m SuperClaude install --minimal
# 開發者設定 (包含所有)
python3 -m SuperClaude install --profile developer
# 查看所有可用選項
python3 -m SuperClaude install --help
# 快速設定 (推薦給大多數用戶)
SuperClaude install
# 互動式選擇 (選擇組件)
SuperClaude install --interactive
# 最小化安裝 (僅核心框架)
SuperClaude install --minimal
# 開發者設定 (包含所有)
SuperClaude install --profile developer
# 查看所有可用選項
SuperClaude install --help
就是這樣!🎉 安裝器處理所有事情:框架檔案、MCP 服務器和 Claude Code 配置。
這是 SuperClaude
最核心的功能。您可以透過在任何指令後方加上 --persona-<name>
旗標,讓 AI 戴上特定專家的「帽子」來思考。
可用的角色包括:
- architect: 系統架構師,專注於高層次設計、擴展性和模式。
- frontend: 前端工程師,專注於使用者體驗 (UI/UX) 和無障礙設計。
- backend: 後端工程師,專注於 API、資料庫和系統可靠性。
- security: 安全專家,專注於威脅模型、零信任和漏洞評估。
- analyzer: 分析師,擅長根本原因分析和基於證據的調查。
- qa: 品質保證工程師,專注於測試、邊界案例和驗證。
- performance: 效能專家,專注於優化、分析和效率。
- refactorer: 重構專家,專注於程式碼品質和維護性。
- mentor: 導師,擅長教學、解釋概念和知識傳遞。
- scribe: 文書專家,專注於清晰溝通和文檔撰寫。
範例:
# 請安全專家審查這段程式碼
/sc:analyze --files src/auth.ts --persona-security
# 請前端專家協助建立 UI 元件
/sc:implement --feature "Login Form" --persona-frontend
您可以控制 AI 分析問題的深度,以平衡速度和全面性。
旗標 | 描述 |
---|---|
--think |
進行跨檔案分析,擴展上下文。 |
--think-hard |
進行架構層級的深度分析。 |
--ultrathink |
進行關鍵系統的極限深度分析。 |
SuperClaude
可以與多種 MCP (Model Context Protocol) 伺服器整合,以擴展其能力。
- Context7 (
--c7
): 存取外部函式庫文件。 - Sequential (
--seq
): 進行多步驟的邏輯推理。 - Magic (
--magic
): 產生 AI 生成的 UI 元件。 - Playwright (
--playwright
): 進行瀏覽器自動化測試。
注意: 您需要在 Claude Code
的設定中單獨安裝和啟用這些 MCP 伺服器。
--uc
或--ultracompressed
: 啟用超壓縮模式,可以顯著減少複雜任務中的 Token 消耗。--no-mcp
: 停用所有 MCP 工具,僅使用原生功能,以節省 Token。
以下旗標適用於所有 SuperClaude
指令。
--think
: 標準深度分析。--think-hard
: 架構級深度分析。--ultrathink
: 極限深度分析。
--uc
,--ultracompressed
: 啟用超壓縮模式。
--c7
,--seq
,--magic
,--playwright
: 分別啟用指定的 MCP 伺服器。--all-mcp
: 啟用所有 MCP 伺服器。--no-mcp
: 禁用所有 MCP 伺服器。
--plan
: 在執行前顯示詳細的執行計畫。--dry-run
: 預覽變更而不實際執行。--watch
: 持續監控並提供即時回饋。--interactive
: 進入步驟式引導模式。--force
: 強制執行,跳過安全檢查。
--validate
: 執行前進行增強的安全檢查。--security
: 進行以安全為核心的分析。--coverage
: 產生程式碼覆蓋率分析。--strict
: 啟用零容忍模式,進行最嚴格的驗證。
SuperClaude 的 9 個認知角色基於企業級開發需求設計,每個角色都有獨特的思維模式和工具偏好:
核心信念:系統必須設計為可變更 決策模式:優先考慮長期可維護性而非短期修復 企業應用場景:
- 微服務架構設計:
/sc:design --api --ddd --bounded-context --persona-architect
- 系統重構規劃:
/sc:analyze --architecture --seq --persona-architect
- 技術債務評估:
/sc:analyze --code --think --persona-architect
核心信念:用戶體驗決定產品成功 決策模式:移動優先、直觀界面設計 企業應用場景:
- 企業級 UI 設計:
/sc:implement --react --magic --persona-frontend
- 響應式設計:
/sc:implement --react --magic --watch --persona-frontend
- 可訪問性優化:
/sc:analyze --accessibility --persona-frontend
核心信念:可靠性和性能至關重要 決策模式:注重可擴展性和數據完整性 企業應用場景:
- API 開發:
/sc:implement --api --tdd --coverage --persona-backend
- 微服務實現:
/sc:implement --api --tdd --coverage --persona-backend
- 數據層設計:
/sc:design --database --persona-backend
核心信念:威脅無處不在(「偏執設計」) 決策模式:威脅模型和縱深防禦 企業應用場景:
- 安全審計:
/sc:analyze --security --owasp --deps --persona-security
- 威脅建模:
/sc:analyze --security --persona-security
- 合規檢查:
/sc:test --validate --deps --persona-security
核心信念:每個症狀都有多個潛在原因 決策模式:系統性假設形成和測試 企業應用場景:
- 生產問題分析:
/sc:troubleshoot --investigate --prod --persona-analyzer
- 根因分析:
/sc:troubleshoot --prod --persona-analyzer
- 效能瓶頸識別:
/sc:analyze --profile --perf --seq --persona-analyzer
核心信念:質量不是偶然的 決策模式:邊界情況和測試覆蓋 企業應用場景:
- 測試策略:
/sc:test --coverage --e2e --strict --persona-qa
- 品質保證:
/sc:test --integration --e2e --playwright --persona-qa
- 自動化測試:
/sc:test --coverage --e2e --strict --persona-qa
核心信念:速度是一個功能 決策模式:數據驅動優化 企業應用場景:
- 效能優化:
/sc:improve --performance --threshold 95% --persona-performance
- 負載測試:
/sc:test --load --persona-performance
- 監控設置:
/sc:monitor --performance --persona-performance
核心信念:代碼是為人類閱讀的 決策模式:代碼可讀性和可維護性 企業應用場景:
- 遺留代碼重構:
/sc:improve --quality --persona-refactorer
- 代碼審查:
/sc:review --quality --evidence --persona-refactorer
- 技術債務清理:
/sc:analyze --code --persona-refactorer
核心信念:理解通過引導發現成長 決策模式:循序漸進的學習方法 企業應用場景:
- 技術培訓:
/sc:explain --depth expert --visual --persona-mentor
- 代碼解釋:
/sc:explain --depth beginner --examples --persona-mentor
- 知識轉移:
/sc:document --user --persona-mentor
核心信念:清晰的溝通是成功的基礎。 決策模式:注重信息準確性、可讀性和一致性。 企業應用場景:
- 技術文檔撰寫:
/sc:document --technical --persona-scribe
- 報告生成:
/sc:document --report --persona-scribe
- 代碼註釋生成:
/sc:explain --comments --persona-scribe
用於在專案中實現新功能或模組。
--feature "name"
: 實現指定名稱的新功能。--tdd
: 採用測試驅動開發流程。--react
,--api
,--fullstack
: 使用預設的技術棧範本(React, Node.js API, 全端)。
範例:
# 在現有專案中新增一個 "使用者認證" 功能
/sc:implement --feature "User Authentication" --tdd --persona-backend
用於編譯和打包專案。
--output <path>
: 指定編譯輸出的路徑。--debug
: 啟用偵錯模式。
範例:
# 編譯並打包專案到指定目錄
/sc:build --output dist/
用於進行系統架構、API 和資料庫設計。
--api
: 設計 API 介面。--ddd
: 採用領域驅動設計。--bounded-context "name"
: 為指定的有界上下文進行設計。--database
: 設計資料庫結構。--system
: 進行高層次系統設計。
範例:
# 使用 DDD 設計一個新的訂單管理系統 API
/sc:design --api --ddd --bounded-context "Order Management" --persona-architect
# 設計資料庫結構
/sc:design --database --persona-backend
對程式碼、架構、效能進行全面分析。
--code
: 程式碼品質分析。--architecture
: 系統設計評估。--profile
: 效能分析。--deps
: 依賴項分析。
範例:
# 對整個專案的程式碼和架構進行深度分析
/sc:analyze --code --architecture --think-hard --seq --persona-architect
系統化地解決問題。
--investigate
: 進行系統性問題分析。--five-whys
: 使用「五個為什麼」方法進行根本原因分析。--prod
: 針對生產環境問題進行除錯。--perf
: 針對效能問題進行調查。
範例:
# 調查生產日誌中回報的 "502 Bad Gateway" 錯誤
/sc:troubleshoot --prod --investigate "502 Bad Gateway" --persona-analyzer
產生各種技術文件和解釋。
--depth <level>
: 指定解釋的深度 (ELI5
到expert
)。--visual
: 產生圖表(如 Mermaid.js)。--api
: 產生 API 文件。--tutorial
: 產生教學文件。
範例:
# 為專案的 API 產生專家級別的、包含圖表和範例的參考文件
/sc:explain --api --depth expert --visual --examples --seq --persona-mentor
進行有衡量指標的改進。
--quality
: 改善程式碼結構。--performance
: 進行效能優化。--refactor
: 進行系統性重構。--modernize
: 更新老舊的技術棧。
範例:
# 迭代地重構程式碼,直到品質分數達到 95%
/sc:improve --quality --refactor --iterate --threshold 95% --persona-refactorer
建立、執行和維護測試。
--e2e
,--integration
,--unit
: 指定測試類型(端到端、整合、單元)。--performance
: 進行效能測試。--accessibility
: 進行無障礙功能測試。--parallel
: 平行執行測試。
範例:
# 使用 Playwright 執行完整的端到端測試並計算覆蓋率
/sc:test --coverage --e2e --playwright --persona-qa
移除無用程式碼、依賴或資源。
--all
: 清理所有類型的冗餘。--validate
: 清理前進行驗證。
範例:
# 清理所有無用的程式碼和依賴
/sc:cleanup --all --validate
產生各種專案文檔。
--user
: 產生使用者手冊。--technical
: 產生技術文檔。--api
: 產生 API 文檔(同explain --api
)。
範例:
# 產生專案的使用者手冊
/sc:document --user --persona-mentor
提供 Git 相關操作的輔助。
--commit
: 協助撰寫提交訊息。--branch
: 管理分支。--rebase
: 執行 rebase 操作。
範例:
# 協助撰寫提交訊息
/sc:git --commit --interactive
評估專案或功能的複雜度和所需工作量。
--feature "name"
: 估算指定功能的工時。--detailed
: 提供詳細的估算報告。--worst-case
: 提供最壞情況的估算。
範例:
# 估算開發一個電商網站所需的工作
/sc:estimate --feature "e-commerce website" --detailed --seq
協助管理專案任務。
--add "task description"
: 添加新任務。--complete <task_id>
: 完成指定任務。--list
: 列出所有任務。
範例:
# 添加一個新任務
/sc:task --add "更新使用者介面"
建立專案的語義索引,以便快速查找和理解程式碼。
--force
: 強制重新建立索引。
範例:
# 建立專案索引
/sc:index
載入整個專案或特定部分的上下文,以便 AI 進行深度分析。
--depth <level>
: 指定載入深度(shallow
,deep
)。
範例:
# 載入整個專案的深度上下文
/sc:load --depth deep
啟動一個新的開發環境或容器。
--env <name>
: 啟動指定名稱的環境。--docker
: 啟動 Docker 容器。
範例:
# 啟動開發環境 Docker 容器
/sc:spawn --docker
SuperClaude
的指令集完整覆蓋了現代軟體開發生命週期(SDLC)的各個階段。您可以將 SuperClaude
視為在整個開發流程中與您協作的 AI 工程師團隊。
以下是 SDLC 各階段如何對應到 SuperClaude
指令的範例:
在這個初始階段,您需要定義專案的範圍、目標和可行性。
/sc:explain
: 澄清複雜的技術概念或商業邏輯。/sc:estimate
: 評估專案的複雜度和所需工作量。
範例:
# 解釋微服務架構的優缺點
/sc:explain --architecture "microservices" --depth intermediate --persona-mentor
# 估算開發一個電商網站所需的工作
/sc:estimate --feature "e-commerce website" --detailed --seq
定義系統的技術架構、資料庫結構和 API 介面。
/sc:design
: 進行系統架構和 API 設計。/sc:analyze
: 分析現有程式碼或架構以供參考。
範例:
# 使用 DDD 設計一個新的訂單管理系統 API
/sc:design --api --ddd --bounded-context "Order Management" --persona-architect
# 產生 API 的 OpenAPI (Swagger) 文件
/sc:explain --api --reference --persona-backend
撰寫程式碼,實現功能。
/sc:implement
: 根據設計建立專案、功能或元件。
範例:
# 根據設計稿,使用 TDD 方式建立使用者認證功能
/sc:implement --feature "User Authentication" --tdd --persona-backend
# 建立一個包含監控的 CI/CD 開發環境
/sc:build --init --ci --monitor # 調整為 /sc:build,因為 /dev-setup 不在v3核心指令中
確保軟體品質,找出並修復錯誤。
/sc:test
: 執行各種測試(單元、整合、E2E)。/sc:analyze
: 進行程式碼審查以發現潛在問題 (原 /review 功能可由 analyze 實現)。/sc:analyze --security
: 掃描程式碼中的安全漏洞 (原 /scan 功能可由 analyze --security 實現)。
範例:
# 對整個專案執行端到端測試,並檢查程式碼覆蓋率
/sc:test --e2e --coverage --playwright --persona-qa
# 請安全專家審查所有關於驗證的程式碼
/sc:analyze --files "src/auth" --security --persona-security
將應用程式發佈到生產環境。
/sc:build
: 規劃與執行部署流程 (原 /deploy 功能可由 build 配合相關旗標實現,例如打包部署)。/sc:analyze --security
: 在部署前進行最後的安全驗證 (原 /scan 功能可由 analyze --security 實現)。
範例:
# 規劃一個到 AWS 生產環境的藍綠部署計畫
/sc:build --deploy --env prod --plan --strategy blue-green --persona-architect # 調整為 /sc:build,並加入 deploy 旗標
# 部署前掃描所有依賴項的漏洞
/sc:analyze --deps --security --validate
監控線上狀況、修復問題並進行效能優化。
/sc:troubleshoot
: 調查並解決生產環境中的問題。/sc:improve
: 針對效能、可讀性等方面進行重構與優化。/sc:cleanup
: 移除無用程式碼或依賴。
範例:
# 調查生產日誌中回報的 "502 Bad Gateway" 錯誤
/sc:troubleshoot --prod --investigate "502 Bad Gateway" --persona-analyzer
# 針對資料庫查詢進行效能優化
/sc:improve --performance --refactor "database queries" --persona-performance
SuperClaude 為微服務架構提供完整的開發生命週期支援:
# 階段一:架構設計
/persona:architect
/sc:design --api --ddd --bounded-context
/sc:estimate --detailed --worst-case --seq
# 階段二:服務實現
/persona:backend
/sc:implement --api --tdd --coverage # /build 變更為 /sc:implement
# 階段三:前端整合
/persona:frontend
/sc:implement --react --magic --watch # /build 變更為 /sc:implement
# 階段四:測試與部署
/persona:qa
/sc:test --integration --e2e --playwright # /pup 變更為 /playwright
/sc:build --deploy --env staging --plan # /deploy 變更為 /sc:build --deploy
企業級優勢:
- 獨立服務管道:每個微服務有獨立的 CI/CD 管道
- 容器化支援:自動生成 Docker 配置和 Kubernetes 部署檔案
- 服務發現:自動配置服務註冊和發現機制
SuperClaude 提供端到端的 DevOps 支援:
# 開發環境設置
/sc:build --init --ci --monitor # /dev-setup 不在v3核心指令中,改為 /sc:build
# 部署規劃
/sc:build --deploy --env prod --plan # /deploy 變更為 /sc:build --deploy
# 資料庫遷移
/sc:migrate --dry-run --rollback
# 安全審計
/sc:analyze --security --owasp --deps # /scan 變更為 /sc:analyze --security
CI/CD 整合特點:
- Git 工作流程整合:自動生成有意義的提交訊息和變更日誌
- 多環境支援:支援 staging、production 等多環境部署
- 回滾機制:內建回滾和檢查點系統
SuperClaude 在程式碼審查方面表現出色:
# 完整程式碼審查
/sc:analyze --quality --evidence --persona-qa # /review 變更為 /sc:analyze
# 安全性審查
/sc:analyze --security --validate --persona-security # /scan 變更為 /sc:analyze --security
# 性能分析
/sc:analyze --profile --perf --seq --persona-performance
品質保證優勢:
- 證據驅動審查:要求 AI 提供具體證據支持其建議
- 多維度分析:涵蓋安全性、效能、可維護性等多個維度
- 學習工具:幫助團隊成員理解最佳實踐
- 設計:
/sc:design --api --ddd --persona-architect
(使用領域驅動設計來設計 API) - 估算:
/sc:estimate --detailed --seq
(詳細估算開發資源) - 審查:
/sc:analyze --security --validate --persona-security
(進行安全審查,原/scan
) - 建構:
/sc:implement --api --tdd --persona-backend
(以 TDD 方式建構 API,原/build
)
- 調查:
/sc:troubleshoot --investigate --prod --persona-analyzer
(調查生產問題) - 分析:
/sc:analyze --profile --perf --seq
(分析效能瓶頸) - 改進:
/sc:improve --performance --threshold 95% --persona-performance
(進行效能優化) - 驗證:
/sc:test --integration --e2e --playwright
(進行整合測試以驗證修復,原--pup
)
- 前端:
/sc:implement --react --magic --watch --persona-frontend
(使用 AI 元件開發 UI,原/build
) - 後端:
/sc:implement --api --feature "New Endpoint" --tdd --persona-backend
(開發後端 API,原/build
) - 品保:
/sc:test --coverage --e2e --strict --persona-qa
(進行嚴格的 QA 測試) - 安全:
/sc:analyze --validate --deps --persona-security
(部署前進行安全掃描,原/scan
)
功能:自動查找官方文檔,確保使用最新最準確的信息 企業應用:
/sc:build --react --c7 # 自動查詢 React 官方文檔
/sc:design --api --c7 # 查找 API 設計最佳實踐
功能:多步驟推理和複雜系統分析 企業應用:
/sc:troubleshoot --investigate --seq # 複雜問題分析
/sc:design --system --seq # 系統設計推理
功能:生成匹配項目現有風格的 UI 組件 企業應用:
/sc:implement --react --magic # 企業級 React 組件
/sc:design --ui --magic # UI 設計實現
功能:真實瀏覽器測試、性能監控 企業應用:
/sc:test --e2e --playwright # 端到端測試
/sc:monitor --perf --playwright # 性能監控
# 必須在 Claude Code 的 MCP 設定中單獨安裝
npm install -g @modelcontextprotocol/server-sequential-thinking
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-playwright
# 配置範例(編輯 ~/.claude/claude_desktop_config.json)
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"playwright": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-playwright"]
}
}
}
SuperClaude 的 Token 優化策略實現了 70% 的成本節省:
# 啟用 UltraCompressed 模式
/sc:analyze --architecture --uc
/sc:implement --react --magic --uc # /build 變更為 /sc:implement
/sc:explain --depth expert --uc
優化技術:
- 符號化語法:→ (to)、& (and)、@ (at)、w/ (with)
- 代碼經濟:默認生成精簡、無樣板的代碼
- 智能模型路由:簡單任務使用 Sonnet,複雜任務使用 Opus
# 標準分析(~4K tokens)
/sc:analyze --code --think
# 深度分析(~10K tokens)
/sc:design --api --think-hard
# 最大深度分析(~32K tokens)
/sc:troubleshoot --prod --ultrathink
# 1. 專案初始化
/sc:load --depth deep
# 2. 架構設計
/persona:architect
/sc:design --api --ddd --bounded-context
/sc:estimate --detailed --worst-case
# 3. 開發實現
/persona:backend
/sc:implement --api --tdd --coverage # /build 變更為 /sc:implement
/persona:frontend
/sc:implement --react --magic --watch # /build 變更為 /sc:implement
# 4. 品質保證
/persona:qa
/sc:test --coverage --e2e --strict
# 5. 性能優化
/persona:performance
/sc:analyze --profile --perf
/sc:improve --performance --threshold 95%
# 6. 安全檢查
/persona:security
/sc:analyze --security --owasp --deps # /scan 變更為 /sc:analyze --security
# 7. 部署規劃
/sc:build --deploy --env staging --plan # /deploy 變更為 /sc:build --deploy
# 生產環境問題處理
/sc:troubleshoot --investigate --prod --persona-analyzer
# 性能監控
/sc:monitor --performance --alerts --persona-performance
# 代碼維護
/sc:cleanup --all --validate --persona-refactorer
- 架構師:系統設計和技術決策
- 前端/後端開發者:功能實現和優化
- QA 專家:測試策略和品質保證
- 安全專家:安全審查和合規檢查
- 性能專家:性能優化和監控
- 導師:知識轉移和技術培訓
# 團隊配置標準化
{
"scripts": {
"commit": "superclaude commit --interactive",
"release:prep": "superclaude changelog && superclaude readme",
"code:review": "superclaude review --verbose",
"docs:update": "superclaude docs"
}
}
專案背景:某大型電商平台面臨性能瓶頸和架構老化問題,需要進行全面的系統重構。
解決方案:
# 階段 1:系統分析
/persona:architect
/sc:load --depth deep
/sc:analyze --architecture --seq
# 階段 2:性能評估
/persona:performance
/sc:analyze --profile --perf --seq
/sc:improve --performance --threshold 90%
# 階段 3:安全審查
/persona:security
/sc:analyze --security --owasp --deps # /scan 變更為 /sc:analyze --security
# 階段 4:實施重構
/persona:refactorer
/sc:improve --quality --iterate
實施結果:
- 性能提升 90%:響應時間從 2 秒降至 200ms
- 安全漏洞修復 100%:通過 OWASP Top 10 審查
- 程式碼品質顯著改善:技術債務減少 80%
- 開發效率提升 5 倍:新功能開發時間縮短
專案背景:金融科技公司需要將單體應用拆分為微服務架構,以支援業務快速擴展。
解決方案:
# 領域驅動設計
/persona:architect
/sc:design --api --ddd --bounded-context
# 微服務實現
/persona:backend
/sc:implement --api --tdd --coverage # /build 變更為 /sc:implement
# 前端微前端架構
/persona:frontend
/sc:implement --react --magic --microfrontend # /build 變更為 /sc:implement
# 整合測試
/persona:qa
/sc:test --integration --e2e --playwright # /pup 變更為 /playwright
實施結果:
- 服務獨立性:實現 15 個獨立微服務
- 部署頻率:從月度部署提升至日常部署
- 開發團隊擴展:支援 3 個團隊並行開發
- 系統可靠性:99.9% 服務可用性
專案背景:傳統企業需要實現 DevOps 轉型,建立現代化的 CI/CD 流程。
解決方案:
# CI/CD 流程設計
/sc:design --cicd --pipeline --persona-architect
# 自動化測試
/persona:qa
/sc:test --automation --coverage --e2e
# 監控和警報
/sc:monitor --comprehensive --alerts --persona-performance
# 安全整合
/sc:analyze --security --pipeline --automated # /scan 變更為 /sc:analyze --security
解決方案:
# 檢查 Node.js 版本
node --version # 需要 18+
# 重新安裝 MCP 服務器
claude mcp add -s user sequential-thinking npx @modelcontextprotocol/server-sequential-thinking
claude mcp add -s user magic npx @21st-dev/magic@latest --env API_KEY=XXX
claude mcp add -s user context7 -- npx -y @upstash/context7-mcp@latest
claude mcp add -s user playwright npx @playwright/mcp@latest
# 檢查配置文件
cat ~/.claude/claude_desktop_config.json
解決方案:
# 檢查目錄權限
ls -la ~/.claude/
# 修復權限
chmod -R 755 ~/.claude/
chown -R $USER:$USER ~/.claude/
解決方案:
# 啟用 UltraCompressed 模式
/sc:analyze --architecture --uc
# 使用更經濟的思考模式
/sc:analyze --code --think # 而非 --ultrathink
# 分批處理任務
/sc:build --feature --incremental # /build 變更為 /sc:build,並調整功能為分批處理編譯/打包任務
解決方案:
# 明確指定角色
/persona:architect
/sc:design --api --ddd
# 使用角色特定的工具
/sc:analyze --architecture --seq --persona-architect
解決方案:
# 設置環境變數
export CLAUDE_API_KEY="your_api_key"
export SUPERCLAUDE_HOME="~/.claude"
# 配置 CI/CD 腳本
#!/bin/bash
source ~/.claude/setup.sh
/sc:build --ci --test --deploy # /build 變更為 /sc:build,並加入 ci/test/deploy 旗標
解決方案:
# 建立團隊配置標準
cp ~/.claude/RULES.md /shared/team-rules.md
# 同步配置
./install.sh --team-config /shared/team-rules.md
基於企業特定需求,可以創建自訂角色:
# custom-personas.md
## DevOps 工程師
- 核心信念:自動化一切可自動化的
- 主要問題:如何提高部署效率和系統可靠性?
- 決策模式:基礎設施即代碼,持續交付
- 偏好工具:Sequential(流程設計)、Playwright(自動化測試)
## 數據工程師
- 核心信念:數據是企業最寶貴的資產
- 主要問題:如何確保數據質量和可靠性?
- 決策模式:數據治理優先,性能和準確性並重
- 偏好工具:Sequential(數據流設計)、C7(最佳實踐研究)
# 創建企業模板
mkdir ~/.claude/templates/enterprise
# API 開發模板
cat > ~/.claude/templates/enterprise/api-template.md << 'EOF'
# 企業 API 開發模板
@include shared/security-patterns.yml#Enterprise_Security
@include shared/performance-patterns.yml#API_Optimization
@include shared/documentation-patterns.yml#API_Documentation
EOF
# 微服務模板
cat > ~/.claude/templates/enterprise/microservice-template.md << 'EOF'
# 微服務開發模板
@include shared/architecture-patterns.yml#Microservice_Design
@include shared/deployment-patterns.yml#Container_Deployment
@include shared/monitoring-patterns.yml#Service_Monitoring
EOF
# 性能指標配置
cat > ~/.claude/shared/performance-kpi.yml << 'EOF'
performance_thresholds:
response_time: 200ms
throughput: 1000 rps
error_rate: 0.1%
availability: 99.9%
monitoring:
- cpu_usage: 70%
- memory_usage: 80%
- disk_usage: 85%
- network_latency: 50ms
EOF
# 代碼品質指標
cat > ~/.claude/shared/quality-metrics.yml << 'EOF'
quality_gates:
test_coverage: 90%
code_complexity: 10
duplication: 5%
security_rating: A
review_checklist:
- 單元測試覆蓋率
- 錯誤處理機制
- 性能影響評估
- 安全性檢查
EOF
- 智能代碼補全:基於 SuperClaude 角色的上下文感知補全
- 實時代碼審查:在編輯器中提供即時的代碼品質反饋
- 自動重構建議:基於最佳實踐的自動重構推薦
- 多租戶支援:支援大型企業的多團隊、多專案管理
- 權限管理:基於角色的訪問控制(RBAC)
- 審計追蹤:完整的操作記錄和合規報告
- 模型專業化:針對不同角色和領域的專門模型
- 本地化部署:支援企業私有雲部署
- 自學習能力:基於企業代碼庫的自適應學習
- 團隊培訓:為開發團隊提供 SuperClaude 使用培訓
- 基礎設施:建立 MCP 服務器和配置管理
- 流程標準化:制定企業級使用規範和最佳實踐
- 工具整合:與現有 DevOps 工具鏈深度整合
- 自動化流程:建立基於 SuperClaude 的自動化 CI/CD 流程
- 性能監控:實施全面的性能指標和監控體系
- 企業級定制:開發企業特定的角色和命令
- 知識管理:建立企業級的 AI 輔助知識管理系統
- 創新應用:探索新的 AI 輔助開發模式和工作流程
從技術架構師的角度分析,SuperClaude 代表了 AI 輔助開發的重要進步。它不僅是一個提高開發效率的工具,更是一個能夠改變企業軟體開發文化和流程的戰略性技術平台。
專業化:通過 9 個認知角色,SuperClaude 提供了針對不同技術領域的專業化 AI 輔助,確保每個開發階段都有相應的專家級支援。
標準化:基於證據驅動的開發方法論,SuperClaude 幫助企業建立統一的開發標準和最佳實踐,降低代碼品質的不一致性。
經濟性:70% 的 Token 優化和智能模型路由,大幅降低企業 AI 使用成本,提高投資回報率。
可擴展性:模塊化的架構設計和 MCP 工具生態,確保 SuperClaude 能夠適應企業不斷變化的技術需求。
對於希望在企業級軟體開發中採用 SuperClaude 的技術領導者,建議採用漸進式實施策略:從核心開發團隊開始試點,逐步擴展至整個技術組織。重點關注開發效率提升、代碼品質改善和團隊協作優化三個關鍵指標。
SuperClaude 的真正價值在於其能夠將 AI 技術無縫整合到現有的企業級開發流程中,成為每位開發者的智能夥伴,推動整個技術組織向更高效、更專業的方向發展。隨著技術的不斷演進和企業的深度採用,SuperClaude 必將成為現代軟體開發不可或缺的重要工具。