💡 歡迎使用 SuperClaude 框架！

本手冊涵蓋所有 25 個命令、15 個專業代理 + 商業專家團、7 種行為模式 和 8 個 MCP 伺服器，包含詳細的使用方法和豐富的實戰案例。每個功能都經過精心設計，讓您的開發工作更加高效、智能。

🎯 快速開始

安裝 SuperClaude

# 推薦方式（pipx）
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install

# 或使用 npm
npm install -g @bifrost_inc/superclaude && superclaude install

# 或使用 pip
pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install

首次使用

安裝完成後，在 Claude Code 中輸入：

/sc:help

將顯示所有可用命令列表。讓我們開始探索吧！

💻 開發工作流

常見的開發工作流命令，助您從需求到部署的全週期開發：

/sc:brainstorm - 交互式需求探索
通過蘇格拉底式對話，將模糊的想法轉化為清晰的技術規格

語法

/sc:brainstorm [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel] [主題/想法]
示例 1: 系統化產品探索
/sc:brainstorm --strategy systematic --depth deep "AI-driven project management tool"
✨ 效果:
  • 多專家分析（架構師、分析師、項目經理）
  • 使用 Sequential MCP 提供結構化探索框架
  • 生成完整的需求文檔

💡 實用場景

SaaS 產品概念探索
/sc:brainstorm --strategy systematic --depth shallow --parallel "Team collaboration project management tool with AI assistant"
背景:
產品概念情境：

  • 對整合 AI 助手的團隊協作專案管理工具有模糊想法
  • 不確定核心價值主張和目標使用者群體
  • 不清楚具體的 AI 整合場景
  • 需要系統化探索以釐清產品定位和功能範圍
結果:
需求探索已完成，已識別使用者故事、核心功能及技術堆疊。可進入設計階段。
團隊協作工具開發
/sc:brainstorm --strategy agile --depth normal "Team collaboration project management tool with AI assistant"
背景:
開發規劃情境：

  • 想開發團隊協作工具
  • 不確定能提供真正價值的核心功能
  • 需要在競爭市場中識別差異化優勢
結果:
已透過系統化對話釐清核心功能及價值主張。可開始建立產品需求文件。
功能優先順序評估
/sc:brainstorm --strategy enterprise --depth deep "Feature prioritization: User feedback system vs Advanced analytics vs Third-party integrations"
背景:
優先順序挑戰：

  • 產品待辦清單累積了來自不同持份者的 20+ 個功能請求
  • 開發資源有限（小型團隊）
  • 需要數據驅動的優先順序排序以最大化影響
  • 必須平衡快速成果與長期策略功能
結果:
功能優先排序已完成，並提供數據驅動的建議及實作路線圖。
💡 最佳實踐:
  • 想法越模糊，越適合使用這個命令
  • 讓 Claude 引導對話，回答提出的問題
  • 保存生成的需求文檔供後續開發使用
/sc:implement - 功能實現
使用智能專家協調和 MCP 集成實現功能和代碼

語法

/sc:implement [--type component|api|service|feature] [--framework react|vue|express] [--safe] [--with-tests] [功能描述]
示例: React 組件實現
/sc:implement --type component --framework react "user login form"
✨ 效果:
  • 前端架構師專家激活
  • Magic MCP 生成現代 UI 組件
  • Context7 MCP 提供 React 最佳實踐
  • 自動生成組件測試
示例 1.2: API 端點
/sc:implement --type api --framework express --safe "payment processing interface"
✨ 效果:
  • Express REST API
  • 包含錯誤處理和輸入驗證
  • 安全模式防止常見漏洞
示例 1.3: 完整功能模組
/sc:implement --type feature --framework react --with-tests --magic --c7 "real-time chat system"
✨ 效果:
  • 完整的前端和後端實作
  • 包含單元測試和整合測試
  • Magic 生成美觀 UI
  • Context7 提供最佳實務
  • 自動設定 WebSocket 連線
示例 1.4: 微服務實作
/sc:implement --type service --framework express --with-tests --seq --think-hard "order processing microservice"
✨ 效果:
  • 獨立微服務架構
  • 包含訊息佇列整合
  • Sequential 深度分析業務邏輯
  • 自動生成 Docker 配置

💡 實用場景

檔案上傳功能
/sc:implement --type feature --framework react --safe --with-tests "Large file upload with chunking and resume"
背景:
實作需求：

  • 需要實作支援分塊機制的大型檔案上傳
  • 必須支援最大 2GB 的檔案
  • 需要即時更新的進度追蹤
  • 需要恢復能力以處理網路中斷
  • 必須向使用者顯示準確的上傳進度
結果:
檔案上傳功能已實作，並已提供驗證及進度追蹤。
使用者驗證系統
/sc:implement --type api --framework express --safe --with-tests "User authentication system (registration, login, JWT)"
背景:
系統需求：

  • 需要實作完整的使用者驗證系統
  • 必須包含帶電子郵件驗證的使用者註冊
  • 需要帶 JWT 令牌管理的安全登入
  • 技術堆疊：Express.js + JWT + bcrypt 用於密碼雜湊
  • 必須設計帶加密密碼的使用者模型
  • 需要帶適當驗證的註冊和登入 API 端點
  • 需要用於受保護路由的驗證中介軟體
結果:
驗證系統已實作，並已提供安全的令牌處理及會話管理。
💡 最佳實踐:
  • 描述要清晰明確，包含關鍵需求
  • 生產代碼始終使用 --safe
  • 使用 --with-tests 確保測試覆蓋
/sc:design - 系統設計
設計系統架構、API介面和元件結構,提供可擴展的技術方案

語法

/sc:design [--type architecture|api|component|database] [--format diagram|spec|code] "<系統/元件>"

參數

  • --type: : 設計類型
    • architecture
    • api
    • component
    • database
  • --format: : 輸出格式
    • diagram
    • spec
    • code
示例: API設計
/sc:design --type api --format spec "User Authentication API"
✨ 效果:
  • OpenAPI規範
  • 端點定義
  • 安全方案
示例: 資料庫設計
/sc:design --type database --format code "E-commerce Order System"
✨ 效果:
  • 資料庫架構
  • ER圖
  • SQL腳本
示例 9.3: 微服務架構設計
/sc:design --type architecture --format diagram --ultrathink --c7 ""
✨ 效果:
  • 完整架構圖
  • 服務通訊設計
  • 資料流程圖
  • 技術堆疊選擇
  • 可擴展性規劃

💡 實用場景

即時協作 API 設計
/sc:design --type api --format spec "Real-time Document Collaboration API"
背景:
設計需求：

  • 需要設計即時協作文件編輯功能
  • 需要適當的多使用者編輯 API 結構
  • 必須處理資料同步和衝突解決
  • 需要跨所有連接客戶端的即時更新
結果:
API 設計已完成，規格及文件已準備好可供實作。
支付系統架構重構
/sc:design --type architecture --format diagram "Payment System Refactoring"
背景:
重構挑戰：

  • 電商系統支付程式碼混亂，組件間高度耦合
  • 難以添加新支付提供商或修改現有流程
  • 需要在重構前重新設計架構
  • 必須確保關注點清晰分離和可測試性
結果:
系統架構已定義，並已記錄組件互動及部署策略。
💡 最佳實踐:
  • 先設計再編碼,避免返工
  • 考慮系統的可擴展性和可維護性
  • 使用 --format diagram 產生視覺化文件
  • 設計評審後再進入實作階段

💾 會話管理

保存和加載您的開發會話，實現跨會話的上下文持久化：

/sc:save - 會話保存
使用 Serena MCP 保存會話上下文和發現

語法

/sc:save [--type session|learnings|context|all] [--summarize] [--checkpoint]

參數

  • --type: : 保存類型
    • session
    • learnings
    • context
    • all
  • --summarize: : 生成摘要
  • --checkpoint: : 建立可恢復檢查點
示例: 綜合檢查點
/sc:save --type session
✨ 效果:
  • 完整會話保存和恢復檢查點
  • 包含所有學習、上下文和進度
  • 可用於會話恢復
示例: 保存學習要點
/sc:save --type all --checkpoint --summarize
✨ 效果:
  • 保存當前會話中的學習要點和技術發現
  • 使用標籤分類便於後續查找
  • 建立專案知識庫和最佳實踐

💡 實用場景

儲存除錯工作階段進度
/sc:save "payment-bug-analysis"
背景:
工作階段情境：

  • 正在處理複雜的支付整合錯誤
  • 工作日即將結束
  • 取得需要保留的重要除錯進度
  • 希望明天繼續調查而不失去上下文
結果:
除錯會話已儲存，已記錄進度及發現以供日後繼續。
記錄專案架構學習
/sc:save "project-architecture-overview"
背景:
知識捕獲情境：

  • 與團隊完成深入的架構討論
  • 做出重要的技術堆疊決策
  • 需要保留架構理由供未來參考
  • 希望使知識可供團隊入職使用
結果:
專案學習已儲存至持久性儲存以保留知識。
儲存效能優化見解
/sc:save "react-performance-optimization"
背景:
優化完成：

  • 剛完成 React 組件渲染效能優化
  • 發現關於不必要重新渲染的關鍵見解
  • 應用 React.memo 和 useCallback 優化
  • 達成顯著的效能改善
  • 希望為類似情境記錄解決方案
結果:
系統架構已定義，並已記錄組件互動。
💡 最佳實踐:
  • 重要突破後立即保存
  • 長會話每 30 分鐘建立檢查點
  • 會話結束前使用 --summarize
/sc:load - 會話加載
使用 Serena MCP 加載專案上下文和歷史會話

語法

/sc:load [--type session|learnings|context|all] [--checkpoint id]

參數

  • --type: : 加載類型
    • session
    • learnings
    • context
    • all
  • --checkpoint: : 指定要加載的檢查點ID
  • --analyze: : 加載時自動分析專案結構
  • --refresh: : 刷新上下文
示例: 從檢查點恢復
/sc:load --type project --analyze ""
✨ 效果:
  • 恢復特定檢查點的會話狀態
  • 重新加載進度和上下文
  • 繼續中斷的工作
示例: 加載最近會話
/sc:load --type checkpoint --refresh "session_20250118_1430"
✨ 效果:
  • 快速加載最近的工作會話
  • 恢復上一次的程式碼上下文和思路
  • 無縫繼續之前的開發任務

💡 實用場景

繼續昨天的除錯工作階段
/sc:load "payment-bug-analysis"
背景:
工作恢復情境：

  • 開始新的工作日
  • 昨天正在除錯驗證問題
  • 需要快速恢復上下文並從中斷處繼續
  • 希望無縫繼續工作流程而無需重新分析問題
結果:
會話內容已成功還原，完整專案狀態可用。
載入專案記憶
/sc:load "ecommerce-platform"
背景:
專案啟動情境：

  • 在處理另一個程式碼庫後切換到不同專案
  • 需要回憶專案特定的上下文、架構和慣例
  • 希望快速重新啟動而無需手動查看文件
結果:
專案內容已啟用，已載入架構及開發模式。
恢復學習上下文
/sc:load "nextjs-learning"
背景:
學習恢復：

  • 上週正在學習 Next.js App Router 架構
  • 做了筆記並用範例練習
  • 需要從中斷處繼續學習
  • 希望回憶關鍵概念和下一個學習步驟
結果:
系統架構已定義，並已記錄組件互動。
💡 最佳實踐:
  • 啟動新會話時立即加載專案上下文
  • 切換專案前先保存當前會話再加載新專案
  • 定期使用 --refresh 刷新過期上下文
  • 使用 --analyze 自動分析專案結構

🎯 高級功能

強大的高級命令，用於解決複雜的開發場景：

/sc:task - 複雜任務執行
使用智能工作流管理和委派執行複雜任務

語法

/sc:task [--parallel] [--validate] [任務描述] [--delegate auto|files|folders]
示例: 大規模重構
/sc:task --delegate auto --validate "refactor authentication system"
✨ 效果:
  • 自動任務分解和委派
  • 並行專家協作
  • 執行前風險評估

💡 實用場景

端到端功能實作
/sc:task --parallel --validate "Integrate Stripe payment (requirements → design → implementation → testing → deployment)"
背景:
需要從需求到部署完成支付整合功能。
結果:
功能實作已透過完整工作流程進行編排，所有階段均已成功完成。
問題診斷和修復
/sc:task --parallel --validate "Production environment memory leak"
背景:
生產環境出現記憶體洩漏，需要完整的診斷和修復工作流程。
結果:
問題已透過系統化故障排除工作流程診斷並解決。
專案初始化
/sc:task --parallel --validate "Next.js + TypeScript + Tailwind project"
背景:
啟動新的 Next.js 專案，需要完整的專案設定。
結果:
系統架構已定義，並已記錄組件互動。
/sc:workflow - 工作流生成
從PRD和功能需求生成結構化的實現工作流

語法

/sc:workflow [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel] [--delegate auto] ""
示例: 從PRD生成工作流
/sc:workflow --strategy agile "User Management System"
✨ 效果:
  • 解析PRD識別關鍵功能
  • 生成分階段實施計劃
  • 估算每個階段所需時間
  • 識別依賴關係和風險
  • 輸出詳細工作流文檔
示例 7.2: 系統性工作流程
/sc:workflow --strategy systematic --depth deep "@requirements.prd"
✨ 效果:
  • 系統性方法論
  • 詳細任務分解
  • 相依性圖表
示例 7.3: 企業平行工作流程
/sc:workflow --strategy enterprise --depth deep --parallel --delegate auto "@product-spec.md"
✨ 效果:
  • 企業級流程
  • 平行任務執行
  • 自動任務分配
  • 甘特圖生成
  • 團隊協作計劃

💡 實用場景

功能開發標準流程
/sc:workflow --strategy systematic --depth normal "New Feature Development Standard Process"
背景:
團隊有許多新成員，需要標準化功能開發流程。
結果:
開發工作流程已結構化，並已定義清晰的階段及團隊協作指引。
錯誤修復流程
/sc:workflow --strategy agile --depth shallow "Bug Fix Standard Process"
背景:
錯誤修復流程不規範，經常遺漏步驟導致返工。
結果:
錯誤修復工作流程已標準化，並已記錄調查、解決及驗證步驟。
企業平行工作流程
/sc:workflow --strategy enterprise --depth deep --parallel --delegate auto "@product-spec.md"
背景:
大型專案需要多團隊協作，需要企業工作流程規劃。
結果:
已應用改進，並已達成可衡量的效能提升。
💡 最佳實踐:
  • 確保PRD包含清晰的需求定義
  • 使用 --estimate 進行資源規劃
  • 定期更新工作流跟蹤進度
  • 考慮團隊規模調整時間估算
/sc:spawn - 任務編排
元系統任務編排，智能分解和委派大型複雜任務

語法

/sc:spawn "任務描述" [--strategy sequential|parallel|adaptive] [--breakdown auto] [--delegate agents]
示例: 大型項目編排
/sc:spawn --strategy adaptive --breakdown auto --delegate agents "Build complete e-commerce admin system"
✨ 效果:
  • 任務分解: 用戶管理、商品管理、訂單系統、支付集成、數據分析
  • 代理分配: backend-architect（架構）、security-engineer（支付安全）、frontend-architect（管理界面）
  • 執行策略: 架構設計→並行開發→集成測試
  • 智能調度和進度跟蹤

💡 實用場景

多功能平行開發
/sc:spawn --strategy adaptive --breakdown auto "user avatar upload, comment system, search optimization"
背景:
Sprint 需要同時開發 3 個獨立功能，希望透過平行處理加速開發。
結果:
任務編排已完成，所有平行開發流程均已成功執行。
多環境部署
/sc:spawn --strategy parallel --breakdown auto "Deploy to test, staging, and production environments"
背景:
需要同時部署到測試、預備和生產環境。
結果:
平行部署已成功完成，涵蓋所有目標環境。
複雜問題分而治之
/sc:spawn --strategy adaptive --breakdown auto "Analyze slow API, frontend lag, and database query performance"
背景:
系統效能問題複雜，需要分解為多個子問題並平行分析。
結果:
系統架構已定義，並已記錄組件互動。
💡 最佳實踐:
  • 適用於大型、多模塊項目
  • 讓系統智能分配代理和策略
  • 定期檢查子任務進度
  • 複雜依賴使用 sequential 策略
/sc:reflect - 任務反思
任務反思和驗證，使用 Serena MCP 分析能力進行質量評估

語法

/sc:reflect [--analyze outcomes|process|quality] [--improve] [--task TasksID]
示例: 實現任務反思
/sc:reflect --task --analyze quality --improve "implement user authentication"
✨ 效果:
  • 分析實現質量（程式碼覆蓋率、安全性）
  • 識別潛在問題（錯誤處理不足、效能隱患）
  • 生成改進建議
  • 自動應用可安全改進的部分
  • 標記需要人工審查的問題

💡 實用場景

任務完成驗證
/sc:reflect --analyze outcomes --improve
背景:
完成使用者驗證功能開發，需要驗證是否滿足所有需求。
結果:
任務完成已驗證，需求覆蓋已確認。
程式碼品質反思
/sc:reflect --analyze process
背景:
重構完成，需要評估程式碼品質是否符合標準。
結果:
程式碼品質驗證已完成，已識別改進領域。
專案里程碑審查
/sc:reflect --analyze quality --improve
背景:
Sprint 結束，需要審查此迭代的成就和問題。
結果:
衝刺審查已完成，已記錄成就並識別改進機會。
💡 最佳實踐:
  • 重要任務完成後及時反思
  • 使用反思結果優化未來工作
  • 定期反思提升開發質量
  • 反思發現的問題及時修復
/sc:select-tool - 工具選擇
基於複雜度評分和操作分析智能選擇 MCP 工具

語法

/sc:select-tool "操作描述" [--suggest] [--compare] [--explain]
示例: 工具選擇建議
/sc:select-tool --suggest --explain "Need to rename function names in 100 files"
✨ 效果:
  • 分析操作複雜度: 中等（批量編輯）
  • 推薦工具: Morphllm MCP（批量模式編輯）
  • 備選方案: Serena MCP（符號重命名）
  • 解釋: Morphllm 更適合模式化的批量替換
  • 預估效率提升: 80%

💡 實用場景

複雜任務工具選擇
/sc:select-tool --suggest --explain "Implement user behavior data analysis and visualization reports"
背景:
需要實作複雜的資料分析功能，不確定哪些 MCP 工具最合適。
結果:
已根據任務複雜度分析建議最佳工具組合。
效能優化工具選擇
/sc:select-tool --suggest --explain "API performance optimization"
背景:
API 回應緩慢，需要選擇適當的效能分析和優化工具。
結果:
已設計工具工作流程，並為系統化優化選用適當的 MCP 伺服器。
學習新框架工具選擇
/sc:select-tool --suggest --explain "Learn Next.js 14 new features"
背景:
團隊需要學習 Next.js 14，需要選擇最佳學習路徑和工具。
結果:
建置已成功完成，並已產生優化的生產環境產出物。
💡 最佳實踐:
  • 不確定用什麼工具時諮詢此命令
  • 使用 --compare 了解不同方案優劣
  • 根據項目規模選擇合適工具
  • 學習工具選擇邏輯提升效率

其他核心命令

更多強大的功能命令

/sc:help - 查看所有命令
快速查看所有可用的 SuperClaude 命令及其功能說明

語法

/sc:help
/sc:analyze - 程式碼品質分析
全面分析程式碼品質、安全性、效能和架構

語法

/sc:analyze [--focus quality|security|performance|architecture] [--depth quick|deep] [--format text|json|report] [--all-mcp] [--validate] [目標]

參數

  • --focus: : 分析焦點
    • quality
    • security
    • performance
    • architecture
  • --depth: : 分析深度
    • quick
    • deep
  • --format: : 輸出格式
    • text
    • json
    • report
  • --all-mcp: : 啟用所有MCP伺服器進行全方位分析
  • --validate: : 驗證分析結果並產生改進計劃
範例: 安全評估
/sc:analyze --focus security --depth quick "src/auth"
✨ 效果:
  • 驗證元件的深度安全分析
  • 漏洞評估和詳細的修復指導
  • OWASP 合規性檢查
示例 2.2: 效能分析
/sc:analyze --focus performance --depth normal "api/"
✨ 效果:
  • 標準效能分析
  • 識別效能瓶頸
  • 提供優化建議
示例 2.3: 深度架構評估
/sc:analyze --focus architecture --depth deep --format report --think-hard --seq "."
✨ 效果:
  • 全面架構分析
  • 生成詳細報告
  • 評估設計模式使用
  • 識別架構債務
  • Sequential 提供重構建議
示例 2.4: 全面品質審查
/sc:analyze --focus quality --depth deep --format json --all-mcp --validate "src/"
✨ 效果:
  • 全面程式碼品質審查
  • JSON 格式便於 CI/CD 整合
  • 覆蓋率和複雜度分析
  • 自動生成改進計劃

💡 實用場景

新功能效能分析
/sc:analyze --focus performance --depth deep --format report "src/search"
背景:
效能調查：

  • 新開發的搜尋功能回應時間緩慢
  • 使用者每次搜尋體驗到 2-3 秒的延遲
  • 需要分析效能瓶頸
  • 必須快速識別優化機會
結果:
效能分析已完成，已識別瓶頸並提供優化建議。
舊程式碼品質評估
/sc:analyze --focus quality --depth deep --format json "src/legacy"
背景:
技術債務評估：

  • 需要對舊程式碼庫進行全面品質分析
  • 從前團隊繼承的程式碼庫，品質狀況不明
  • 必須在規劃重構工作前評估技術債務
  • 需要根據影響程度優先排序改善工作
結果:
程式碼品質評估已完成，並提供可行的改進建議。
💡 最佳實踐:
  • 首次分析使用 --depth quick 快速定位問題區域
  • 針對關鍵模組使用 --depth deep 進行深度分析
  • 定期對核心模組執行 --focus security 安全稽核
  • 使用 --format report 產生團隊可共享的分析報告
  • 結合 --all-mcp 使用多個MCP伺服器進行全方位分析
/sc:research - 深度網絡研究
使用自適應規劃和智能搜索進行深度網絡研究

語法

/sc:research [--depth quick|standard|deep|exhaustive] [--strategy planning_only|intent_planning|unified] [--domains "domain1,domain2"] "[queries]"
示例: 技術最佳實踐
/sc:research --depth quick "latest frontend framework comparison"
✨ 效果:
  • 協作式查詢優化
  • 從官方文檔和社區經驗收集
  • 實用的實施指南
示例 8.2: 標準研究
/sc:research --depth standard --strategy planning "microservices architecture best practices"
✨ 效果:
  • 標準深度研究
  • 多來源資訊整合
  • 實用建議
示例 8.3: 詳盡技術研究
/sc:research --depth exhaustive --strategy unified --serena "zero trust security architecture implementation guide"
✨ 效果:
  • 最詳盡研究
  • 全面資訊收集
  • 比較分析表格
  • Serena 儲存研究結果
  • 趨勢和預測分析

💡 實用場景

技術堆疊研究
/sc:research --strategy unified "React state management comparison 2024"
背景:
技術決策：

  • 需要為新 React 專案選擇狀態管理解決方案
  • 評估 Redux vs Zustand vs Jotai vs React Context
  • 團隊經驗水平不一
  • 希望透過數據驅動決策，了解利弊
結果:
技術選項已分析，並根據專案需求提供建議。
安全最佳實務研究
/sc:research --strategy unified "OAuth 2.0 security best practices and common vulnerabilities"
背景:
安全稽核準備：

  • 準備驗證系統的安全稽核
  • 需要了解目前的最佳實務和標準
  • 希望識別目前實作中的差距
  • 必須提供改善建議
結果:
研究已完成，已記錄安全性最佳實務及實作建議。
/sc:improve - 代碼改進
通過系統化重構和品質提升,改善現有程式碼的可維護性、效能和安全性

語法

/sc:improve [--type quality|performance|maintainability] [--safe] [--preview] [--interactive] [--iterations N] "<目標路徑>"

參數

  • --type: : 改進類型
    • quality
    • performance
    • maintainability
  • --safe: : 安全模式,所有改動需經過測試驗證
  • --preview: : 預覽模式,不實際修改檔案
  • --interactive: : 互動式確認每個改進
  • --iterations: : 迭代改進次數
示例: 效能最佳化
/sc:improve --type performance --safe "src/api/"
✨ 效果:
  • 效能最佳化
  • 安全模式
  • 基準測試
示例: 程式碼品質
/sc:improve --type quality --preview "src/"
✨ 效果:
  • 品質改進預覽
  • 不實際修改
  • 改進清單
示例 10.3: 全面重構
/sc:improve --type maintainability --interactive --iterations 3 --morph ""
✨ 效果:
  • 漸進式重構
  • 3 輪迭代
  • 互動式確認
  • Morphllm 批量重構
  • 可維護性評分改善

💡 實用場景

程式碼品質改善
/sc:improve --type quality --safe "src/auth/legacy"
背景:
程式碼品質提升：

  • 舊驗證模組累積了技術債務
  • 程式碼功能正常但難以維護和測試
  • 需要在不破壞現有功能的情況下改善
  • 希望遵循現代最佳實務
結果:
程式碼品質改進已完成，可維護性及測試覆蓋率已提升。
效能優化
/sc:improve --type performance --safe "src/api/products"
背景:
效能改善：

  • API 回應時間平均 800 毫秒，目標是 <200 毫秒
  • 資料庫查詢效率低下
  • 未實施快取層
  • React 組件不必要地重新渲染
結果:
效能優化已應用，已達成可衡量的改進。
💡 最佳實踐:
  • 改進前先執行測試,確保有測試覆蓋
  • 大範圍改進建議分階段進行,使用 --iterations 迭代改進
  • 生產程式碼務必使用 --safe 模式
  • 使用 --preview 預覽改進效果後再應用
  • 改進後對比效能指標,確保正向提升
/sc:test - 測試執行
執行測試並生成覆蓋率分析和質量報告

語法

/sc:test [--type unit|integration|e2e|all] [--coverage] [--watch] [--fix] [--parallel] [--concurrency N] [--validate] [目標]
示例: 覆蓋率分析
/sc:test --type unit --coverage "src/utils"
✨ 效果:
  • 特定目錄的單元測試
  • 詳細的覆蓋率指標（行、分支、函數）
  • 未覆蓋代碼的可視化
示例 3.2: 監視模式
/sc:test --type unit --watch "src/"
✨ 效果:
  • 檔案變更時自動重新執行測試
  • 即時回饋
  • 適合 TDD 開發
示例 3.3: E2E 測試套件
/sc:test --type e2e --fix --play --verbose ""
✨ 效果:
  • 端對端測試
  • 自動修復失敗測試案例
  • Playwright 瀏覽器自動化
  • 詳細日誌輸出
示例 3.4: 完整測試流程
/sc:test --type all --coverage --parallel --concurrency 4 --validate "."
✨ 效果:
  • 所有測試平行執行
  • 速度提升 4 倍
  • 完整覆蓋率分析
  • 結果驗證和報告

💡 實用場景

全面功能測試
/sc:test --type all --coverage --validate "src/auth"
背景:
功能驗證：

  • 剛完成使用者驗證功能實作
  • 需要驗證所有功能按規格運作
  • 必須測試邊緣情況和錯誤場景
  • 合併前需要全面的測試覆蓋
結果:
測試已識別需要修復的失敗，方可繼續。
重構後回歸測試
/sc:test --type all --coverage --validate "src/payments"
背景:
重構驗證：

  • 剛完成支付處理模組的重大重構
  • 更改了內部實作但 API 應保持不變
  • 需要確保現有功能未被破壞
  • 必須驗證向後相容性
結果:
所有測試均已通過，並已產生全面的覆蓋率報告。可進行程式碼審查。
/sc:build - 項目構建
編譯、打包和準備項目進行部署，支持多環境配置和優化

語法

/sc:build [--type dev|prod] [--clean] [--optimize] [--validate] [--parallel]
示例 1: 生產環境構建
/sc:build --type dev --verbose "frontend/"
✨ 效果:
  • 清理 dist/ 目錄
  • 編譯 TypeScript/ES6+ 代碼
  • 壓縮 JavaScript 和 CSS
  • 優化圖片和靜態資源
  • 生成 source maps
  • 構建大小分析報告
示例 2: 開發環境熱更新
/sc:build --type prod --clean "."
✨ 效果:
  • 快速增量構建
  • 監聽文件變化
  • 自動刷新瀏覽器
  • 保留詳細的錯誤堆棧
示例 5.3: 優化建置流程
/sc:build --type prod --clean --optimize --validate --parallel "."
✨ 效果:
  • 完全優化生產環境建置
  • 平行建置任務
  • 建置結果驗證
  • 效能分析報告
  • Tree-shaking 和程式碼分割
示例 5.4: 多環境建置
/sc:build --type all --environments "dev,staging,prod" --dockerize ""
✨ 效果:
  • 同時建置多個環境
  • 生成 Docker 映像
  • 環境特定配置
  • 準備部署

💡 實用場景

優化生產環境建置
/sc:build --type prod --optimize --validate --clean
背景:
生產環境部署準備：

  • 準備發佈 v2.0 生產版本
  • 需要經過最小化和 tree-shaking 優化的建置
  • 必須確保所有資源正確打包
  • 需要 source maps 以除錯生產環境問題
結果:
建置已成功完成，並已產生優化的生產環境產出物。
CI/CD 整合建置
/sc:build --type prod --optimize --validate --parallel --clean
背景:
持續整合設定：

  • 在 GitHub Actions 設定自動化建置流程
  • 需要跨環境的一致、可重現建置
  • 必須在建置前執行測試和品質檢查
  • 需要建置產物以進行部署自動化
結果:
建置已成功完成，並已產生優化的生產環境產出物。
💡 最佳實踐:
  • 生產構建前運行測試，確保代碼質量
  • 使用 --clean 避免舊文件殘留導致的問題
  • 開發環境使用 --watch 提升開發效率
  • 檢查構建大小報告，識別大型依賴
/sc:git - Git 操作
使用智能提交信息和工作流優化進行 Git 操作

語法

/sc:git [commit|merge|rebase|pr|flow] [--smart-commit] [--interactive] [--push] [--create-pr] [--squash] [--create] [--title " "] [--auto-description] [parameters]
示例: 智能提交
/sc:git commit --smart-commit
✨ 效果:
  • 從變更分析生成規範化提交信息
  • 應用最佳實踐和一致格式
  • 自動分類變更類型（feat、fix、docs 等）
示例 4.2: 互動式合併
/sc:git merge --interactive ""
✨ 效果:
  • 智能衝突解決
  • 逐步合併指導
  • 提供最佳實務建議
示例 4.3: 完整 Git 工作流程
/sc:git flow --smart-commit --push --create-pr ""
✨ 效果:
  • 自動建立分支
  • 智能提交訊息
  • 推送並建立 PR
  • 生成變更摘要

💡 實用場景

功能開發 Git 工作流程
/sc:git flow --smart-commit --push --create-pr
背景:
功能分支管理：

  • 開發新的儀表板分析功能
  • 開發期間進行多次提交
  • 需要在 PR 前建立乾淨的提交歷史
  • 希望推送至遠端並建立拉取請求
結果:
變更已提交並已提交程式碼審查，遵循專案慣例。
熱修復部署
/sc:git flow --smart-commit --push --create-pr --title "Hotfix: Payment callback race condition"
背景:
關鍵錯誤修復：

  • 發現生產環境支付處理錯誤
  • 需要從生產分支建立緊急熱修復
  • 必須快速部署修復同時維持 Git 最佳實務
  • 需要合併前進行自動化測試
結果:
緊急修復已部署至生產環境，並已記錄驗證及回滾計劃。
/sc:document - 文檔生成
為代碼、API和組件生成清晰準確的技術文檔

語法

/sc:document [--type api|code|readme|guide] [--format markdown|html|jsdoc] [目標]
示例 1: API文檔
/sc:document --type inline --style brief "utils.js"
✨ 效果:
  • 分析所有API端點
  • 生成請求/響應示例
  • 參數說明和類型定義
  • 狀態碼和錯誤處理文檔
  • 生成 API.md 文件
示例 2: README生成
/sc:document --type api --style detailed "src/api/"
✨ 效果:
  • 項目簡介和特性
  • 安裝和快速開始
  • 配置說明
  • 使用示例
  • 貢獻指南
示例 13.3: 使用者指南
/sc:document --type guide --style detailed --format markdown --toc ""
✨ 效果:
  • 完整使用者指南
  • 目錄結構
  • 圖表說明
  • 最佳實務
  • 搜尋友善

💡 實用場景

API 文件生成
/sc:document --type api --format markdown "src/api/"
背景:
文件需求：

  • 後端 API 缺乏全面文件
  • 前端團隊難以理解端點契約
  • 需要產生最新的 API 參考文件
  • 希望包含請求/回應範例
結果:
API 文件已產生，並提供全面的端點參考及範例。
組件庫文件
/sc:document --type code --format markdown "src/components/"
背景:
組件文件：

  • React 組件庫在沒有文件的情況下增長
  • 開發人員不確定如何使用現有組件
  • 需要記錄 props、使用範例和最佳實務
  • 希望建立互動式組件展示
結果:
組件文件已建立，並提供使用範例及屬性規格。
💡 最佳實踐:
  • 文檔與代碼同步更新
  • 提供豐富的使用示例
  • API文檔包含完整的請求響應示例
  • 保持文檔簡潔易懂，避免過度技術化
/sc:cleanup - 程式碼清理
系統化清理程式碼庫,移除無用程式碼、最佳化專案結構

語法

/sc:cleanup [--type imports|code|all] [--safe] [--preview] [--aggressive] [--interactive] [--backup]

參數

  • --type: : 清理類型
    • imports
    • code
    • all
  • --safe: : 安全模式,保守處理
  • --preview: : 預覽模式,不實際修改
  • --aggressive: : 激進模式(謹慎使用)
  • --interactive: : 逐個確認清理項
  • --backup: : 自動備份
示例: 清理匯入
/sc:cleanup --type imports --safe "src/"
✨ 效果:
  • 清理未使用匯入
  • 保守處理
  • 快速執行
示例: 刪除死程式碼
/sc:cleanup --type code --preview "."
✨ 效果:
  • 識別死程式碼
  • 預覽模式
  • 清理報告
示例 11.3: 激進清理
/sc:cleanup --type all --aggressive --interactive --backup ""
✨ 效果:
  • 全面深度清理
  • 激進模式（謹慎使用）
  • 逐項確認
  • 自動備份
  • 清理統計報告

💡 實用場景

舊程式碼清理
/sc:cleanup --type code --safe --preview "src/"
背景:
程式碼清理需求：

  • 專案累積了未使用的程式碼和已棄用的功能
  • 死程式碼影響程式碼庫的可維護性
  • 需要安全地移除過時組件
  • 必須確保不會破壞活躍功能
結果:
舊程式碼已移除，並已透過驗證測試確認功能無損失。
相依套件清理和更新
/sc:cleanup --type all --safe --backup
背景:
相依套件管理：

  • Package.json 包含過時和存在漏洞的相依套件
  • npm audit 報告多個安全漏洞
  • 需要在不破壞變更的情況下安全更新套件
  • 希望移除未使用的相依套件
結果:
程式碼庫清理已完成，已移除未使用的程式碼並更新依賴項。
💡 最佳實踐:
  • 定期清理,避免技術債務累積
  • 清理前執行測試,確保不破壞功能
  • 始終使用 --safe 模式進行備份
  • 清理後驗證應用仍正常執行
/sc:troubleshoot - 故障診斷
系統化診斷和解決程式碼問題、建置失敗和執行階段錯誤

語法

/sc:troubleshoot [--type bug|performance|build] [--trace] [--fix] [--safe-mode] "<問題描述>"

參數

  • --type: : 問題類型
    • bug
    • performance
    • build
  • --trace: : 深度堆疊追蹤分析
  • --fix: : 嘗試自動修復問題
  • --safe-mode: : 安全模式,使用保守修復策略
示例: 效能問題
/sc:troubleshoot --type performance --trace "API response slow"
✨ 效果:
  • 效能問題定位
  • 產生火焰圖
  • 識別瓶頸
示例: 建置失敗
/sc:troubleshoot --type build --fix
✨ 效果:
  • 自動檢測建置問題
  • 嘗試自動修復
  • 提供解決方案
示例 6.3: 生產環境除錯
/sc:troubleshoot --type bug --trace --fix --safe-mode --seq ""
✨ 效果:
  • 安全模式除錯
  • 深度堆疊追蹤
  • Sequential 根本原因分析
  • 保守修復策略
  • 效能影響評估

💡 實用場景

生產環境 API 故障調查
/sc:troubleshoot --type bug --trace --fix --safe-mode "checkout API 500 errors"
背景:
關鍵生產問題：

  • 使用者報告結帳 API 出現 500 錯誤
  • 錯誤率突然從正常的 0.1% 飆升至 15%
  • 需要快速識別根本原因
  • 必須盡快恢復服務
結果:
已識別根本原因並實作修復，並已提供監控以防止再次發生。
效能降級根本原因分析
/sc:troubleshoot --type performance --trace --fix "dashboard performance"
背景:
效能問題調查：

  • 儀表板載入時間在過去一週從 2 秒增加到 8 秒
  • 前端沒有最近的程式碼變更
  • 使用者抱怨體驗緩慢
  • 需要找出變更內容並修復
結果:
效能問題已診斷並解決，並已應用優化建議。
💡 最佳實踐:
  • 提供完整的錯誤資訊和上下文
  • 使用 --trace 進行深度堆疊追蹤分析
  • 生產環境問題使用 --safe-mode 確保安全
  • 應用修復後驗證問題已解決
  • 記錄診斷過程,防止問題復發
/sc:explain - 代碼解釋
用清晰的語言解釋代碼、概念和系統行為

語法

/sc:explain [--level beginner|intermediate|expert] [--focus logic|architecture|performance|security] [目標]
示例 1: 解釋複雜函數
/sc:explain --level intermediate --focus security @utils/encryption.js
✨ 效果:
  • 逐步解釋加密算法
  • 說明為什麼選擇這個方案
  • 指出安全關鍵點
  • 解釋參數和返回值
示例 2: 架構解釋
/sc:explain --level beginner --focus architecture "Microservices Architecture"
✨ 效果:
  • 用簡單語言解釋微服務概念
  • 對比單體架構的區別
  • 說明適用場景
  • 提供入門示例

💡 實用場景

複雜演算法解釋
/sc:explain --level beginner "src/cache/lru-cache.ts"
背景:
學習情境：

  • 新團隊成員加入專案
  • 難以理解自訂快取演算法
  • 程式碼缺少註解和文件
  • 需要清晰解釋其運作方式
結果:
已提供演算法說明，並附有逐步分解及視覺範例。
架構模式解釋
/sc:explain --level intermediate --focus architecture "Event sourcing pattern in payment service"
背景:
程式碼審查討論：

  • 團隊討論微服務事件驅動架構
  • 部分開發人員不熟悉事件溯源模式
  • 需要解釋該模式及其使用原因
  • 希望展示優點和權衡
結果:
架構模式已說明，並提供實作指引及最佳實務。
💡 最佳實踐:
  • 根據受眾選擇合適的 --level
  • 請求解釋時提供具體上下文
  • 使用 --focus 聚焦感興趣的方面
  • 解釋後可以提問深入了解
/sc:business-panel - 商業專家面板
多專家商業分析，具有自適應交互模式

語法

/sc:business-panel [--mode discussion|debate|socratic] [--experts "expert1,expert2"] [--focus domain] [document]
示例: 創新評估
/sc:business-panel --mode discussion --focus strategy "SaaS pricing model evaluation"
✨ 效果:
  • Christensen 的 jobs-to-be-done（待完成任務理論）分析
  • Drucker 的客戶價值視角
  • Godin 的市場推廣策略

💡 實用場景

產品策略審查
/sc:business-panel --mode sequential "SaaS project management tool - freemium vs paid subscription strategy"
背景:
策略規劃：

  • 推出新的 SaaS 專案管理產品
  • 需要驗證市場定位和定價策略
  • 評估免費增值 vs 訂閱模式
  • 希望獲得上市策略的專家指導
結果:
業務策略專家小組已完成，並提供市場定位及上市建議。
商業模式轉型評估
/sc:business-panel --mode debate "Pivot from B2C to B2B enterprise model"
背景:
轉型決策：

  • 目前 B2C 模式未達成長目標
  • 考慮轉型至 B2B 企業銷售
  • 需要評估可行性和風險
  • 希望對利弊進行結構化辯論
結果:
業務模式分析已完成，並提供轉型決策框架及風險評估。
/sc:estimate - 開發估算
提供任務、功能或項目的開發時間和資源估算

語法

/sc:estimate [--detail brief|standard|comprehensive] [--team-size N] [--complexity auto|low|medium|high] [任務描述]
示例: 功能估算
/sc:estimate --type time --unit hours "Implement login functionality"
✨ 效果:
  • 複雜度分析: 中等偏高
  • 開發時間: 4-6週（3人團隊）
  • 分解任務: WebSocket服務(1.5週)、消息存儲(1週)、前端UI(1.5週)、測試(1週)
  • 風險因素: 實時性能、並發連接
示例 14.2: 複雜度評估
/sc:estimate --type complexity "Microservice decomposition"
✨ 效果:
  • 技術複雜度
  • 風險評估
  • 難度等級
示例 14.3: 詳細專案估算
/sc:estimate --type effort --unit days --breakdown --team-size 5 ""
✨ 效果:
  • 完整工作量分解
  • 考慮團隊規模
  • 任務相依性
  • 燃盡圖預測
  • 成本估算

💡 實用場景

功能開發估算
/sc:estimate --type time --unit days --breakdown --team-size 3 "Analytics dashboard with charts, filters, CSV export"
背景:
Sprint 規劃：

  • 產品經理要求估算新分析儀表板的時程
  • 功能包含資料視覺化、篩選和匯出能力
  • 需要為 Sprint 規劃提供實際時程
  • 團隊有 3 名開發人員
結果:
開發工作量已評估，並已定義時間表及資源需求。
技術債務重構估算
/sc:estimate --type time --unit days --breakdown "Refactor authentication system to modern architecture"
背景:
重構規劃：

  • 需要重構舊驗證系統
  • 目前程式碼難以維護和測試
  • 必須維持向後相容性
  • 希望在投入資源前獲得實際估算
結果:
重構工作量已評估，並已定義分階段方法及時間表。
💡 最佳實踐:
  • 提供詳細的功能描述以提高準確性
  • 考慮團隊經驗調整估算
  • 預留20-30%的緩衝時間
  • 使用歷史數據校準估算模型
/sc:spec-panel - 規格評審
多專家規格評審，使用著名規格和軟件工程專家進行改進

語法

/sc:spec-panel @spec-document [--mode review|critique|improve] [--focus clarity|completeness|feasibility]
示例: API規格評審
/sc:spec-panel --mode improve --focus completeness @specs/api-design.md
✨ 效果:
  • 專家面板評審（架構師、技術寫作專家）
  • 識別缺失的端點和參數
  • 指出錯誤處理不完整
  • 提供改進建議和示例
  • 生成更完善的規格版本

💡 實用場景

API 規格審查
/sc:spec-panel --mode improve --focus completeness "docs/api-spec.yaml"
背景:
規格審查：

  • 為微服務草擬新的 REST API 規格
  • 需要專家審查最佳實務和潛在問題
  • 希望確保可擴展性和可維護性
  • 需要命名慣例和結構的反饋
結果:
專家小組審查已完成，已提供可行的建議並設定實作優先順序。
資料庫模式審查
/sc:spec-panel --mode critique --focus feasibility "schemas/ecommerce.sql"
背景:
模式驗證：

  • 為電商平台設計資料庫模式
  • 包含使用者、產品、訂單、支付表
  • 需要專家驗證正規化和效能
  • 希望識別潛在的擴展問題
結果:
資料庫結構描述已由專家審查，並已記錄優化建議及最佳實務。
💡 最佳實踐:
  • 規格初稿完成後立即評審
  • 使用 critique 模式發現隱藏問題
  • 評審後根據建議修正規格
  • 重複評審直到達到質量標準
/sc:index - 項目索引
生成全面的項目文檔和知識庫索引，智能組織項目資訊

語法

/sc:index [--type codebase|docs|all] [--depth shallow|deep] [--output markdown|json|html]
示例: 程式碼庫索引
/sc:index --type codebase --depth deep --output markdown
✨ 效果:
  • 掃描整個程式碼庫
  • 生成目錄結構樹
  • 列出所有模組和依賴
  • 提取主要函數和類別
  • 生成 PROJECT_INDEX.md

💡 實用場景

專案知識庫索引
/sc:index --type codebase --depth shallow --output markdown
背景:
新員工需要快速理解專案，建立全面的程式碼索引。
結果:
專案知識庫已索引，可進行快速語意搜尋及導覽。
增量索引更新
/sc:index --type docs --depth deep --output json
背景:
專案頻繁更新，需要定期更新索引以保持最新狀態。
結果:
索引已更新，已納入最新變更以提升搜尋準確度。
特定模組索引
/sc:index --type all --depth shallow --output html
背景:
重構支付模組，只需索引相關程式碼。
結果:
模組索引已產生，依賴關係圖及文件已準備好可供審查。
💡 最佳實踐:
  • 新項目加入時先運行索引
  • 定期更新索引保持同步
  • 使用索引快速導航大型項目
  • 索引可作為新成員的入門文檔

🤖 專業代理

什麼是專業代理？

SuperClaude 框架內置了 15 個專業代理，每個代理都在特定領域擁有深厚的專業知識。代理可以自動激活，也可以通過標誌參數手動指定。

🎨 前端開發代理

frontend-architect
創建可訪問、高性能的用戶界面，專注於用戶體驗和現代框架

專長領域：

  • 現代框架如 React、Vue、Angular
  • 響應式設計和移動端優化
  • Web 無障礙訪問（WCAG 2.1）
  • 性能優化和代碼分割

⚙️ 後端開發代理

backend-architect
設計可靠的後端系統，專注於數據完整性、安全性和容錯性

專長領域：

  • RESTful 和 GraphQL API 設計
  • 數據庫架構和優化
  • 身份驗證和授權
  • 微服務架構

🏗️ 系統架構代理

system-architect
設計可擴展的系統架構，專注於可維護性和長期技術決策

專長領域：

  • 系統設計模式
  • 可擴展性架構
  • 技術選型
  • 架構文檔

🐍 Python 專家代理

python-expert
交付生產就緒、安全、高性能的 Python 代碼，遵循 SOLID 原則

專長領域：

  • Python 最佳實踐
  • FastAPI、Django、Flask
  • 數據處理和分析
  • 異步編程

🚀 DevOps 代理

devops-architect
自動化基礎設施和部署流程，專注於可靠性和可觀察性

專長領域：

  • CI/CD 流水線
  • Docker 和 Kubernetes
  • 監控和日誌
  • 基礎設施即代碼

🔧 重構專家代理

refactoring-expert
通過系統化的重構和清晰的代碼原則提高代碼質量並減少技術債務

專長領域：

  • 代碼異味識別
  • 重構模式
  • 代碼質量指標
  • 技術債務管理

🎓 其他專業代理

SuperClaude 還包括以下專業代理：

  • security-engineer - 安全漏洞識別和合規性
  • quality-engineer - 全面的測試策略
  • performance-engineer - 性能優化
  • learning-guide - 編程教育
  • root-cause-analyst - 根本原因分析
  • requirements-analyst - 需求探索
  • technical-writer - 技術文檔
  • socratic-mentor - 蘇格拉底式教學法
  • business-panel-experts - 商業策略專家團（9 位專家）

🚩 標誌參數參考

標誌參數允許您自定義命令行為。以下是所有可用的標誌：

⚡ 模式激活標誌

這些標誌激活特定的工作模式，以增強 AI 能力和交互方法

標誌說明Token成本適用命令
--brainstorm激活協作探索思考模式，通過蘇格拉底式對話探索需求+2-3K所有命令
--introspect顯示思考過程透明度，讓 AI 展示推理步驟+1-2K所有命令
--task-manage啟用多步驟任務管理，自動跟蹤和組織複雜任務+1K所有命令
--orchestrate啟用多工具並行執行，協調多個 MCP 伺服器和工具+3-5K所有命令
--token-efficient啟用令牌優化模式，在保持質量的同時減少令牌消耗-30-50%所有命令
--plan啟用規劃模式，執行前生成詳細計劃標準implement, design, refactor
--validate啟用驗證模式，自動驗證輸出和結果標準implement, test, build
--parallel啟用並行執行，同時處理多個任務標準test, analyze, research
--interactive啟用交互模式，逐步確認和調整標準brainstorm, design

🔍 分析深度標誌

控制 AI 的分析深度，平衡速度和細節

標誌Token成本說明適用場景
--think~4K標準分析深度，適合常規開發任務日常開發
--think-hard~10K深度分析，多角度思考和驗證複雜問題
--ultrathink~32K最大深度分析，窮盡所有可能性關鍵決策
--depth shallow低快速概覽，適合時間緊迫情況快速檢查
--depth normal標準平衡速度和細節（默認）常規分析
--depth deep高全面深入分析，用於複雜場景詳細評估

🔌 MCP 伺服器控制

選擇性激活 MCP 伺服器以獲得專業能力

標誌別名MCP伺服器用途
--c7--context7Context7框架文檔查詢，獲取官方最新文檔和最佳實踐
--seq--sequentialSequential複雜推理分析，多步驟系統性思考
--magic--magicMagic基於 21st.dev 現代組件庫的 UI 組件生成
--morph--morphllmMorphllm批量代碼編輯，基於模式的快速修改
--serena--serenaSerena項目記憶管理，語義代碼理解和會話持久化
--play--playwrightPlaywright瀏覽器自動化測試，E2E 測試和 UI 驗證

⚙️ 執行控制標誌

控制命令執行方法和行為

標誌說明示例
--dry-run模擬執行而不做實際更改/sc:implement --dry-run
--force強制執行，跳過確認提示/sc:cleanup --force
--auto-commit自動提交更改到 Git/sc:implement --auto-commit
--no-test跳過測試步驟/sc:build --no-test

💡 組合使用示例

標誌可以組合使用以獲得更強大的功能：

  • /sc:analyze --think-hard --serena --c7 "src/api"
    使用深度思考、項目記憶和官方文檔分析 API 代碼
  • /sc:implement --brainstorm --plan --validate "用戶認證"
    協作探索需求、規劃實施並驗證結果
  • /sc:improve --token-efficient --morph --dry-run "src/"
    使用令牌優化和批量編輯工具預覽代碼改進

💡 實用技巧

以下是一些真實的開發場景和推薦的命令組合：

📦 從零開發新功能
/sc:brainstorm "用戶認證功能" --depth deep
/sc:design --think
/sc:implement --plan --validate
/sc:test --parallel
/sc:document
/sc:git "feat: 添加用戶認證"

工作流說明：

  1. 需求探索：明確功能範圍和技術方案
  2. 系統設計：設計認證流程和數據模型
  3. 功能實現：編寫代碼並驗證
  4. 測試驗證：並行運行測試套件
  5. 生成文檔：自動生成 API 文檔
  6. 提交代碼：創建標準 Git 提交
🐛 緊急 Bug 修復流程
/sc:troubleshoot --depth deep
/sc:analyze --focus security
/sc:implement --validate
/sc:test --parallel
/sc:git "fix: 解決認證繞過問題"
🔧 代碼重構和性能優化
/sc:analyze --depth deep
/sc:improve --plan
/sc:test --validate
/sc:cleanup
🎨 React 組件開發
/sc:design "用戶資料卡組件"
/sc:implement --persona frontend-architect
/sc:test --focus accessibility
/sc:document

🎓 學習資源

官方文檔

社區資源

💡 提示：

遇到問題？查看 常見問題 或在 GitHub 提交 Issue。