# Claude Commands 開發流程：從零到專家的完整指南

> 將重複性開發任務轉化為一鍵自動化的強大工具


## 目錄

1. [引言：為什麼需要 Claude Commands？](#引言為什麼需要-claude-commands)
2. [基礎概念與環境設定](#基礎概念與環境設定)
3. [第一個 Command：Hello World](#第一個-commandhello-world)
4. [進階開發技巧](#進階開發技巧)
5. [實用案例研究](#實用案例研究)
6. [團隊協作與最佳實踐](#團隊協作與最佳實踐)
7. [效能優化與故障排除](#效能優化與故障排除)
8. [企業級部署考量](#企業級部署考量)
9. [社群資源與進階學習](#社群資源與進階學習)
10. [未來展望與結論](#未來展望與結論)
11. [實用附錄](#實用附錄)

---

## 引言：為什麼需要 Claude Commands？

在現代軟體開發中，開發者每天都面臨著大量重複性任務：程式碼審查、測試執行、部署流程、文檔生成等。Claude Commands 是 Claude Code 提供的一個強大功能，讓您能夠將這些重複性任務轉化為簡單的斜線指令（slash commands），大幅提升開發效率。

### 🚀 效率革命

傳統開發流程中，一個簡單的程式碼審查可能需要：
1. 切換到正確的分支
2. 查看程式碼變更
3. 執行相關測試
4. 檢查程式碼風格
5. 撰寫審查意見

有了 Claude Commands，這一切只需要一個指令：`/project:review:full`

### 👥 團隊協作

Claude Commands 不僅是個人工具，更是團隊協作的利器：
- **標準化流程**：確保所有團隊成員遵循相同的最佳實踐
- **知識分享**：將專家經驗封裝成可重複使用的指令
- **降低學習曲線**：新成員可以快速上手項目的開發流程

### 🎯 個人化助手

每個開發者都有自己的工作習慣和偏好。Claude Commands 讓您能夠：
- 建立符合個人工作流程的指令
- 整合常用的開發工具和框架
- 累積並重複使用成功的解決方案

---

## 基礎概念與環境設定

### Commands 的兩種類型

Claude Commands 分為兩種類型，各有不同的使用場景：


#### 1. Personal Commands (個人指令)
- **位置**：`~/.claude/commands/`
- **作用範圍**：所有專案都可使用
- **適用場景**：通用開發任務、個人偏好設定

#### 2. Project Commands (專案指令)
- **位置**：`.claude/commands/`
- **作用範圍**：僅限當前專案
- **適用場景**：專案特定流程、團隊協作

### 基本語法結構

Claude Commands 使用簡單的 Markdown 格式：

# 指令說明（可選）

指令的具體內容和提示文字。

可以使用 $ARGUMENTS 來接收傳入的參數。

### 指令調用格式

# Personal Commands
/personal:指令名稱 [參數]

# Project Commands  
/project:指令名稱 [參數]

# 階層式指令
/project:資料夾:指令名稱 [參數]

### IDE 整合設定

#### VS Code 整合
1. 安裝 Claude Code 擴展
2. 在 VS Code 內建終端機中執行 `claude`
3. 使用 `/ide` 指令連接外部終端機

#### JetBrains IDEs 整合
1. 安裝 Claude Code 插件
2. 使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 快速啟動
3. 在內建終端機中直接使用 commands

---

## 第一個 Command：Hello World

讓我們從最簡單的範例開始，建立您的第一個 Claude Command。


### 步驟 1：建立目錄結構

# 為當前專案建立 commands 目錄
mkdir -p .claude/commands

# 或為個人使用建立 commands 目錄
mkdir -p ~/.claude/commands

### 步驟 2：建立第一個指令

建立檔案 `.claude/commands/hello.md`：

# Hello World Command

歡迎使用 Claude Commands！

您傳入的參數是：$ARGUMENTS

這是您的第一個自定義指令，恭喜您開始了 Claude Commands 的學習之旅！

### 步驟 3：測試指令

在 Claude Code 中執行：

/project:hello 這是我的第一個指令

預期輸出：

歡迎使用 Claude Commands！

您傳入的參數是：這是我的第一個指令

這是您的第一個自定義指令，恭喜您開始了 Claude Commands 的學習之旅！

### 💡 小技巧

- 檔案名稱會自動成為指令名稱
- 使用有意義的檔案名稱，如 `code-review.md` 而不是 `cr.md`
- 每個指令都應該有清楚的說明，方便日後維護

---

## 進階開發技巧

### 階層式目錄組織

隨著指令數量增加，良好的組織結構變得重要：


.claude/commands/
├── code-review/
│   ├── security.md          # /project:code-review:security
│   ├── performance.md       # /project:code-review:performance
│   ├── style.md            # /project:code-review:style
│   └── full.md             # /project:code-review:full
├── deploy/
│   ├── staging.md          # /project:deploy:staging
│   ├── production.md       # /project:deploy:production
│   └── rollback.md         # /project:deploy:rollback
├── test/
│   ├── unit.md             # /project:test:unit
│   ├── integration.md      # /project:test:integration
│   └── e2e.md              # /project:test:e2e
└── docs/
    ├── api.md              # /project:docs:api
    ├── readme.md           # /project:docs:readme
    └── changelog.md        # /project:docs:changelog

### 進階參數處理

#### 多重參數使用

# .claude/commands/git/commit.md

請幫我建立一個 Git commit，包含以下資訊：

變更內容：$ARGUMENTS

請確保：
1. Commit 訊息遵循 Conventional Commits 格式
2. 包含適當的 scope 和 type
3. 提供清楚的變更說明
4. 如果是 breaking change，請標註 BREAKING CHANGE

#### 條件式處理

# .claude/commands/test/conditional.md

根據以下條件執行測試：

測試範圍：$ARGUMENTS

請執行：
- 如果參數包含 "unit"，執行單元測試
- 如果參數包含 "integration"，執行整合測試  
- 如果參數包含 "all"，執行所有測試
- 如果沒有參數，詢問使用者要執行哪種測試

### 與 CLAUDE.md 的整合

CLAUDE.md 檔案為 Commands 提供專案上下文：

# CLAUDE.md

## 專案資訊
- 名稱：電商平台 API
- 技術棧：Node.js, Express, MongoDB
- 測試框架：Jest
- 部署平台：AWS ECS

## 開發規範
- 使用 ESLint 和 Prettier
- 遵循 REST API 設計原則
- 所有 API 需要單元測試覆蓋率 > 80%

## 常用指令
- 開發伺服器：`npm run dev`
- 執行測試：`npm test`
- 建置專案：`npm run build`

Commands 可以參考這些資訊：

# .claude/commands/review/api.md

請審查以下 API 程式碼，確保符合專案規範：

程式碼：$ARGUMENTS

審查重點：
1. 遵循 REST API 設計原則（參考 CLAUDE.md）
2. 錯誤處理是否完整
3. 是否有對應的單元測試
4. ESLint 規則是否通過
5. 文檔是否完整

---

## 實用案例研究

### 案例 1：程式碼審查自動化

#### 基礎安全審查

# .claude/commands/review/security.md

請對以下程式碼進行安全審查：

程式碼：$ARGUMENTS

重點檢查項目：
1. **輸入驗證**：是否對所有使用者輸入進行驗證
2. **SQL 注入防護**：是否使用參數化查詢
3. **XSS 攻擊防護**：是否對輸出進行適當編碼
4. **認證授權**：是否有適當的權限檢查
5. **敏感資料處理**：是否遵循資料保護最佳實踐
6. **錯誤處理**：是否避免洩露敏感資訊

請提供具體的改進建議和程式碼範例。

#### 效能優化審查

# .claude/commands/review/performance.md

請分析以下程式碼的效能問題並提出優化建議：

程式碼：$ARGUMENTS

分析重點：
1. **演算法複雜度**：時間和空間複雜度分析
2. **資料庫查詢**：是否有 N+1 問題或缺少索引
3. **記憶體使用**：是否有記憶體洩漏風險
4. **快取策略**：是否可以使用快取提升效能
5. **並發處理**：是否有競態條件或死鎖風險
6. **資源管理**：是否正確關閉連接和釋放資源

請提供效能測試建議和優化後的程式碼範例。

### 案例 2：自動化測試套件

#### 全面測試執行

# .claude/commands/test/comprehensive.md

執行全面的測試套件並產生詳細報告：

測試範圍：$ARGUMENTS

執行步驟：
1. **單元測試**：執行所有單元測試
2. **整合測試**：測試各模組間的整合
3. **API 測試**：驗證 API 端點功能
4. **覆蓋率報告**：產生程式碼覆蓋率報告
5. **效能測試**：基準效能測試
6. **安全測試**：基本安全漏洞掃描

請執行測試並提供：
- 測試結果摘要
- 失敗測試的詳細分析
- 覆蓋率報告解讀
- 改進建議

#### 測試資料生成

# .claude/commands/test/generate-data.md

為以下功能生成測試資料：

功能描述：$ARGUMENTS

請生成：
1. **正常情況**：有效的測試資料
2. **邊界情況**：邊界值測試資料
3. **異常情況**：無效或異常的測試資料
4. **效能測試**：大量資料的測試集
5. **安全測試**：包含潛在攻擊向量的資料

測試資料格式：
- JSON 格式
- 包含註解說明
- 可直接用於自動化測試

### 案例 3：部署自動化

#### 分階段部署

# .claude/commands/deploy/staging.md

執行 Staging 環境部署：

部署內容：$ARGUMENTS

部署流程：
1. **預檢查**：
   - 確認所有測試通過
   - 檢查環境變數設定
   - 驗證資料庫遷移腳本

2. **部署執行**：
   - 建立部署標籤
   - 執行資料庫遷移
   - 部署應用程式
   - 更新設定檔

3. **部署驗證**：
   - 健康檢查
   - 煙霧測試
   - 效能基準測試
   - 日誌檢查

4. **回滾準備**：
   - 建立回滾腳本
   - 備份當前版本
   - 記錄部署資訊

請執行部署並提供詳細的部署報告。

### 案例 4：文檔自動生成

#### API 文檔生成

# .claude/commands/docs/api.md

分析以下 API 程式碼並生成完整的 API 文檔：

API 程式碼：$ARGUMENTS

文檔內容包含：
1. **API 概覽**：
   - 功能描述
   - 版本資訊
   - 基本使用說明

2. **端點詳細資訊**：
   - HTTP 方法和 URL
   - 請求參數說明
   - 請求範例
   - 回應格式和範例
   - 錯誤代碼說明

3. **認證授權**：
   - 認證方式
   - 權限要求
   - 安全注意事項

4. **使用範例**：
   - cURL 指令範例
   - JavaScript 範例
   - Python 範例

5. **變更記錄**：
   - 版本變更歷史
   - 破壞性變更說明

請產生 OpenAPI 3.0 格式的文檔。

---

## 團隊協作與最佳實踐


### 版本控制策略

#### Git 管理最佳實踐

# 將 commands 加入版本控制
git add .claude/commands/
git commit -m "feat: add custom Claude commands for team workflow"

# 建立 .gitignore 規則（如果需要）
echo ".claude/sessions/" >> .gitignore

#### 團隊協作指南

建立 `.claude/commands/README.md`：

# 團隊 Claude Commands

本目錄包含我們團隊的標準化 Claude Commands，幫助提升開發效率和維持程式碼品質。

## 可用指令

### 程式碼審查
- `/project:review:security` - 安全審查
- `/project:review:performance` - 效能審查
- `/project:review:style` - 程式碼風格檢查

### 測試
- `/project:test:unit` - 單元測試
- `/project:test:integration` - 整合測試
- `/project:test:comprehensive` - 全面測試

### 部署
- `/project:deploy:staging` - Staging 部署
- `/project:deploy:production` - Production 部署
- `/project:deploy:rollback` - 回滾部署

## 使用規範

1. **新增指令**：需要經過團隊討論和審查
2. **修改指令**：需要更新文檔並通知團隊
3. **測試指令**：新指令需要經過測試驗證
4. **文檔更新**：保持 README.md 同步更新

## 貢獻指南

1. Fork 本倉庫
2. 建立功能分支
3. 新增或修改指令
4. 更新文檔
5. 提交 Pull Request

### 程式碼審查檢核清單

建立 `.claude/commands/review/checklist.md`：

# 程式碼審查檢核清單

請使用以下檢核清單審查程式碼：$ARGUMENTS

## 🔍 程式碼品質
- [ ] 程式碼遵循團隊編碼規範
- [ ] 變數和函數命名清晰易懂
- [ ] 程式碼結構清晰，職責分離
- [ ] 避免重複程式碼（DRY 原則）
- [ ] 適當的註解和文檔

## 🛡️ 安全性
- [ ] 輸入驗證和清理
- [ ] 輸出編碼防 XSS
- [ ] SQL 注入防護
- [ ] 認證和授權檢查
- [ ] 敏感資料處理

## ⚡ 效能
- [ ] 演算法效率
- [ ] 資料庫查詢優化
- [ ] 記憶體使用合理
- [ ] 無明顯效能瓶頸

## 🧪 測試
- [ ] 單元測試覆蓋率足夠
- [ ] 測試案例涵蓋邊界情況
- [ ] 整合測試完整
- [ ] 測試程式碼品質良好

## 📚 文檔
- [ ] API 文檔完整
- [ ] 程式碼註解適當
- [ ] README 更新
- [ ] 變更記錄更新

## 🔧 維護性
- [ ] 程式碼易於理解和修改
- [ ] 依賴管理合理
- [ ] 錯誤處理完善
- [ ] 日誌記錄適當

請針對每個項目提供具體的審查意見和改進建議。

---

## 效能優化與故障排除

### 常見問題診斷

#### 問題 1：指令無法識別

**症狀**：執行 `/project:my-command` 時出現「指令不存在」錯誤

**可能原因與解決方案**：

# .claude/commands/troubleshoot/command-not-found.md

診斷「指令無法識別」問題：

1. **檢查檔案路徑**：

ls -la .claude/commands/

   確認檔案存在於正確位置

2. **檢查檔案權限**：

chmod 644 .claude/commands/*.md

3. **檢查檔案格式**：
   - 確認副檔名為 `.md`
   - 確認檔案編碼為 UTF-8

4. **重新啟動 Claude Code**：
   有時需要重新啟動才能載入新指令

5. **檢查語法錯誤**：
   確認 Markdown 格式正確

#### 問題 2：參數傳遞失敗

**症狀**：`$ARGUMENTS` 沒有被正確替換

**解決方案**：

# .claude/commands/troubleshoot/arguments-issue.md

診斷參數傳遞問題：

**正確使用方式**：

指令內容：$ARGUMENTS

**常見錯誤**：
- `${ARGUMENTS}` ❌
- `$ARGUMENT` ❌  
- `%ARGUMENTS%` ❌

**測試方法**：
建立測試指令：

# test-args.md
您輸入的參數是：$ARGUMENTS

執行：`/project:test-args hello world`
預期輸出：「您輸入的參數是：hello world」

### 效能最佳化策略

#### 減少重複操作

# .claude/commands/optimize/batch-operations.md

執行批次操作優化：

操作清單：$ARGUMENTS

優化策略：
1. **批次處理**：將多個相似操作合併
2. **快取結果**：避免重複計算
3. **並行執行**：適當使用並行處理
4. **資源重用**：重複使用昂貴的資源

請分析提供的操作並提出優化建議。

#### 記憶體使用優化

# .claude/commands/optimize/memory.md

分析並優化記憶體使用：

目標程式碼：$ARGUMENTS

分析重點：
1. **物件生命週期**：是否及時釋放不需要的物件
2. **資料結構選擇**：是否使用最適合的資料結構
3. **快取策略**：快取大小是否合理
4. **記憶體洩漏**：是否存在記憶體洩漏風險

請提供記憶體優化建議和改進後的程式碼。

---

## 企業級部署考量

### 安全性管理

#### 敏感資料保護

# .claude/commands/security/data-protection.md

檢查程式碼中的敏感資料處理：

檢查目標：$ARGUMENTS

安全檢查項目：
1. **硬編碼秘密**：API 金鑰、密碼、令牌
2. **環境變數使用**：是否正確使用環境變數
3. **資料加密**：敏感資料是否加密存儲
4. **傳輸安全**：是否使用 HTTPS/TLS
5. **日誌安全**：是否避免記錄敏感資訊
6. **存取控制**：是否有適當的權限控制

請提供安全改進建議和最佳實踐。

#### 存取權限控制

# .claude/commands/security/access-control.md

審查存取控制實作：

審查範圍：$ARGUMENTS

檢查重點：
1. **認證機制**：
   - 使用者身份驗證
   - 多因素認證支援
   - 密碼策略

2. **授權控制**：
   - 角色基礎存取控制 (RBAC)
   - 最小權限原則
   - 權限分離

3. **會話管理**：
   - 會話過期處理
   - 會話固定攻擊防護
   - 同時登入限制

4. **審計追蹤**：
   - 存取日誌記錄
   - 敏感操作追蹤
   - 異常行為監控

請提供存取控制改進建議。

### 大規模團隊管理

#### 指令標準化

# .claude/commands/enterprise/standardization.md

建立企業級指令標準：

標準化範圍：$ARGUMENTS

標準化項目：
1. **命名規範**：
   - 使用一致的命名模式
   - 避免縮寫和特殊字符
   - 反映功能的層次結構

2. **文檔規範**：
   - 每個指令都需要清楚說明
   - 包含使用範例
   - 說明參數格式

3. **版本管理**：
   - 使用語義版本控制
   - 記錄變更歷史
   - 向後相容性考量

4. **測試規範**：
   - 指令功能測試
   - 效能基準測試
   - 安全性測試

請建立標準化指南和檢核清單。

#### 多專案整合

# .claude/commands/enterprise/multi-project.md

管理多專案 Claude Commands：

專案清單：$ARGUMENTS

管理策略：
1. **共享指令庫**：
   - 建立公共指令倉庫
   - 版本控制和發布流程
   - 依賴管理

2. **專案特定指令**：
   - 專案配置檔案
   - 環境變數管理
   - 客製化需求

3. **權限管理**：
   - 不同專案的存取權限
   - 敏感操作控制
   - 審計追蹤

4. **維護策略**：
   - 定期更新和維護
   - 廢棄指令管理
   - 使用情況分析

請提供多專案管理的最佳實踐。

---

## 社群資源與進階學習

### 開源範例庫

#### 精選 GitHub 倉庫

1. **[Claude Command Suite](https://github.com/qdhenry/Claude-Command-Suite)**
- 完整的指令集合
- 包含安裝腳本
- 活躍的社群支援

2. **[Awesome Claude Code](https://github.com/hesreallyhim/awesome-claude-code)**
- 精選的指令和工作流程
- 詳細的使用指南
- 社群貢獻內容

3. **[Claude Commands Collection](https://github.com/hikarubw/claude-commands)**
- 多樣化的指令範例
- 不同程式語言支援
- 實用的開發工具

#### 社群最佳實踐

# .claude/commands/community/best-practices.md

收集社群最佳實踐：

主題：$ARGUMENTS

收集來源：
1. **GitHub 討論區**：
   - 問題解決方案
   - 功能請求
   - 最佳實踐分享

2. **技術部落格**：
   - 實戰經驗分享
   - 效能優化技巧
   - 故障排除指南

3. **Discord/Slack 社群**：
   - 即時問題解答
   - 經驗交流
   - 新功能討論

4. **官方文檔**：
   - 最新功能說明
   - 官方範例
   - 更新資訊

請整理相關的最佳實踐和建議。

### 學習路徑規劃


#### 初學者路徑（第 1-2 週）

# 學習目標
- 理解 Claude Commands 基本概念
- 建立第一個可用的指令
- 熟悉基本語法和參數使用

# 實踐項目
1. 建立 Hello World 指令
2. 建立個人化的程式碼格式化指令
3. 建立簡單的測試執行指令

# 資源
- [官方文檔：Slash Commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands)
- [入門教學影片](https://www.youtube.com/watch?v=zcHY88VI1oc)

#### 中級路徑（第 3-6 週）

# 學習目標
- 建立專案專用指令集
- 學習階層式組織
- 與團隊分享指令

# 實踐項目
1. 建立完整的程式碼審查工作流程
2. 建立自動化測試套件
3. 建立部署自動化指令

# 資源
- [團隊協作最佳實踐](https://www.anthropic.com/engineering/claude-code-best-practices)
- [社群指令範例](https://www.claudecode.io/commands)

#### 進階路徑（第 7-12 週）

# 學習目標
- 建立複雜的工作流程自動化
- 整合外部工具和 API
- 優化指令效能

# 實踐項目
1. 建立 CI/CD 整合指令
2. 建立監控和告警系統
3. 建立安全掃描自動化

# 資源
- [企業級部署指南](https://www.claudecode.io/guides/enterprise-deployment)
- [進階整合範例](https://github.com/vincenthopf/claude-code)

#### 專家路徑（第 13+ 週）

# 學習目標
- 貢獻開源社群
- 建立最佳實踐指南
- 培訓其他開發者

# 實踐項目
1. 開發並發布指令庫
2. 撰寫技術文章
3. 參與社群討論和支援

# 資源
- [貢獻指南](https://github.com/anthropics/claude-code)
- [社群討論區](https://discord.gg/claude-code)

---

## 未來展望與結論

### 技術趨勢分析

#### AI 輔助開發的演進

Claude Commands 代表了 AI 輔助開發的一個重要方向：
- **個人化**：根據個人習慣和專案需求客製化
- **自動化**：將重複性任務完全自動化
- **協作化**：促進團隊知識分享和標準化

#### 整合趨勢

未來 Claude Commands 可能會與更多工具整合：
- **IDE 深度整合**：更緊密的編輯器整合
- **CI/CD 平台**：與 GitHub Actions、GitLab CI 等整合
- **監控系統**：與 APM 工具整合進行智能分析
- **專案管理工具**：與 Jira、Trello 等整合

### 實際效益評估

#### 開發效率提升

根據社群回饋，使用 Claude Commands 的開發者平均可以：
- **節省 30-50% 的重複性任務時間**
- **提升 20-30% 的程式碼品質**
- **減少 40-60% 的人為錯誤**

#### 團隊協作改善

- **標準化程度提升**：團隊成員遵循統一的最佳實踐
- **知識分享效率**：專家經驗可以快速傳播
- **新人上手速度**：降低學習曲線

### 行動呼籲

#### 立即開始

1. **建立第一個指令**：

   mkdir -p .claude/commands
   echo "開始您的 Claude Commands 之旅：$ARGUMENTS" > .claude/commands/start.md

2. **測試指令**：

   /project:start 我的第一個指令

#### 持續學習

- **加入社群**：參與 Discord 或 GitHub 討論
- **分享經驗**：撰寫部落格文章或製作教學影片
- **貢獻開源**：為社群指令庫貢獻程式碼

#### 建立最佳實踐

- **文檔化**：為每個指令建立清楚的文檔
- **版本控制**：使用 Git 管理指令變更
- **測試驗證**：確保指令的可靠性和安全性

---

## 實用附錄

### A. Command 開發檢核清單

#### 📝 開發前檢查
- [ ] 確認指令的目的和使用場景
- [ ] 檢查是否已有類似的指令
- [ ] 規劃指令的參數和輸出格式
- [ ] 選擇適當的檔案名稱和位置

#### 🔧 開發中檢查
- [ ] 使用清楚易懂的提示文字
- [ ] 正確使用 `$ARGUMENTS` 變數
- [ ] 包含必要的說明和範例
- [ ] 考慮錯誤處理和邊界情況

#### ✅ 開發後檢查
- [ ] 測試指令的基本功能
- [ ] 測試不同的參數組合
- [ ] 確認輸出格式符合預期
- [ ] 添加或更新相關文檔

#### 👥 團隊協作檢查
- [ ] 遵循團隊的命名規範
- [ ] 更新 README.md 說明
- [ ] 通過程式碼審查
- [ ] 與團隊成員分享使用方法

### B. 故障排除對照表

| 問題症狀 | 可能原因 | 解決方案 |
|---------|----------|----------|
| 指令無法識別 | 檔案路徑錯誤 | 檢查 `.claude/commands/` 目錄 |
| 指令無法識別 | 檔案權限問題 | 執行 `chmod 644 *.md` |
| 指令無法識別 | 檔案格式錯誤 | 確認副檔名為 `.md` |
| 參數無法傳遞 | 語法錯誤 | 使用 `$ARGUMENTS` 而非其他格式 |
| 參數無法傳遞 | 編碼問題 | 確認檔案編碼為 UTF-8 |
| 指令執行緩慢 | 指令內容過於複雜 | 簡化指令邏輯，分解為多個步驟 |
| 指令執行緩慢 | 外部依賴過多 | 減少不必要的外部調用 |
| 輸出格式錯誤 | 提示文字不清楚 | 重新撰寫更明確的提示 |
| 輸出格式錯誤 | 缺少輸出格式說明 | 在指令中明確指定輸出格式 |

### C. 範本庫

#### 基礎指令範本

# .claude/commands/template/basic.md

# 指令名稱：[指令功能簡述]

## 用途
[詳細說明指令的用途和使用場景]

## 參數
$ARGUMENTS

## 執行內容
[具體的指令執行內容]

## 範例
使用方式：`/project:template:basic 參數範例`

#### 程式碼審查範本

# .claude/commands/template/code-review.md

# 程式碼審查範本

請審查以下程式碼：

**程式碼**：$ARGUMENTS

**審查重點**：
1. 程式碼品質和可讀性
2. 潛在的安全風險
3. 效能優化機會
4. 測試覆蓋率
5. 文檔完整性

**輸出格式**：
- 整體評估
- 具體問題列表
- 改進建議
- 優先級排序

#### 測試執行範本

# .claude/commands/template/test-runner.md

# 測試執行範本

執行測試套件：$ARGUMENTS

**執行步驟**：
1. 環境檢查
2. 依賴安裝
3. 測試執行
4. 結果分析

**輸出報告**：
- 測試結果摘要
- 失敗測試詳情
- 覆蓋率報告
- 效能指標

#### 部署自動化範本

# .claude/commands/template/deployment.md

# 部署自動化範本

執行部署流程：$ARGUMENTS

**部署階段**：
1. 預檢查
2. 建置
3. 測試
4. 部署
5. 驗證

**安全措施**：
- 回滾計劃
- 監控設定
- 日誌記錄
- 通知機制

### D. 參考資源

#### 官方文檔
- [Claude Code 官方文檔](https://docs.anthropic.com/en/docs/claude-code)
- [Slash Commands 參考](https://docs.anthropic.com/en/docs/claude-code/slash-commands)
- [CLI 參考文檔](https://docs.anthropic.com/en/docs/claude-code/cli-reference)

#### 社群資源
- [Claude Code 社群指南](https://www.claudecode.io)
- [GitHub 官方倉庫](https://github.com/anthropics/claude-code)
- [Discord 社群](https://discord.gg/claude-code)

#### 技術文章
- [Claude Code 最佳實踐](https://www.anthropic.com/engineering/claude-code-best-practices)
- [開發工作流程優化](https://algarch.com/blog/supercharge-your-development-workflow-mastering-claude-code-slash-commands)
- [IDE 整合指南](https://apidog.com/blog/claude-code-ide-integrations/)

---

**作者**：Claude Code 社群
**最後更新**：2024年7月
**版本**：1.0

> 這份指南是開源的，歡迎在 GitHub 上貢獻改進建議和新的範例！

---

*祝您的 Claude Commands 開發之旅充滿成功！* 🚀