docs: update documents

Author: 薛華慶, james.hsueh

docs/COMMANDS.md

@@ -2,6 +2,18 @@
 
 本文件說明所有可用的 SDD 工作流程指令以及何時使用它們。
 
+## 平台差異
+
+不同 AI 平台使用不同的指令格式：
+
+| 平台 | 格式 | 範例 |
+|------|------|------|
+| Claude Code | `/sdd-*` | `/sdd-auto Create a user login` |
+| Codex (OpenAI) | `/sdd-*` | `/sdd-auto Create a user login` |
+| GitHub Copilot | `@workspace /sdd-*` | `@workspace /sdd-auto Create a user login` |
+
+> 本文件使用 Claude/Codex 格式 (`/sdd-*`)。如使用 GitHub Copilot，請在指令前加上 `@workspace`。
+
 ## 指令概覽
 
 ### 核心工作流程（必需）
@@ -34,6 +46,8 @@
 ```
 
 **範例：**
+
+**Claude Code / Codex:**
 ```bash
 /sdd-auto Implement a VIP discount system in Python where VIP users get 20% off purchases over $100
 
@@ -42,6 +56,15 @@
 /sdd-auto Build a task manager in Go with create, update, delete, and list operations
 ```
 
+**GitHub Copilot:**
+```bash
+@workspace /sdd-auto Implement a VIP discount system in Python where VIP users get 20% off purchases over $100
+
+@workspace /sdd-auto Create a referral bonus system in TypeScript. When an invited user makes a purchase over $50, the inviter gets 100 points
+
+@workspace /sdd-auto Build a task manager in Go with create, update, delete, and list operations
+```
+
 **它會做什麼：**
 1. ✅ 生成 Gherkin 規格（Phase 1）
 2. ✅ 設計架構文件（Phase 2）

docs/INDEX.md

@@ -13,7 +13,7 @@ GSI-Protocol（Gherkin-Structure-Implementation）工作流程的完整文件。
 | **[快速入門指南](QUICKSTART.md)** | 5 分鐘快速開始教學 | 5 分鐘 |
 | **[安裝指南](INSTALL.md)** | 所有情境的詳細安裝說明 | 10 分鐘 |
 | **[Python 安裝器](PYTHON_INSTALLER.md)** | 使用 uvx 的現代化安裝方式 | 3 分鐘 |
-| **[平台支援](PLATFORM_SUPPORT.md)** | Claude Code vs Codex 比較 | 5 分鐘 |
+| **[平台支援](PLATFORM_SUPPORT.md)** | Claude Code、Codex、GitHub Copilot 比較 | 5 分鐘 |
 
 ### 參考
 
@@ -192,7 +192,7 @@ GSI-Protocol（Gherkin-Structure-Implementation）工作流程的完整文件。
 **"如何安裝？"**
 → [安裝指南](INSTALL.md)
 
-**"應該選 Claude Code 還是 Codex？"**
+**"應該選 Claude Code、Codex 還是 GitHub Copilot？"**
 → [平台支援](PLATFORM_SUPPORT.md)
 
 **"有哪些可用指令？"**

docs/INSTALL.md

@@ -5,6 +5,7 @@
 **支援平台：**
 - ✅ Claude Code
 - ✅ Codex (OpenAI)
+- ✅ GitHub Copilot
 
 ---
 
@@ -25,7 +26,7 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/in
 ```
 
 安裝腳本會引導您完成：
-1. 選擇 AI 平台（Claude Code、Codex 或兩者）
+1. 選擇 AI 平台（Claude Code、Codex、GitHub Copilot 或多個）
 2. 選擇安裝位置（全域或當前專案）
 3. 自動完成設定
 
@@ -128,6 +129,20 @@ wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/
 wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-verify.md
 ```
 
+**GitHub Copilot:**
+```bash
+mkdir -p ~/.copilot/commands
+cd ~/.copilot/commands
+
+# 下載所有指令檔案
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-auto.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-spec.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-arch.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-integration-test.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-impl.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-verify.md
+```
+
 ### 手動專案內安裝
 
 **在當前專案中：**
@@ -150,8 +165,18 @@ wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/
 wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-impl.md
 wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-verify.md
 
+# GitHub Copilot
+mkdir -p .copilot/commands
+cd .copilot/commands
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-auto.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-spec.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-arch.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-integration-test.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-impl.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-verify.md
+
 # 提交到 Git（可選）
-git add .claude/commands/ .codex/prompts/
+git add .claude/commands/ .codex/prompts/ .copilot/commands/
 git commit -m "Add GSI-Protocol workflow commands"
 ```
 
@@ -171,11 +196,18 @@ ls ~/.claude/commands/ | grep sdd
 ls ~/.codex/prompts/ | grep sdd
 ```
 
+**GitHub Copilot (全域安裝):**
+```bash
+ls ~/.copilot/commands/ | grep sdd
+```
+
 **專案內安裝:**
 ```bash
 ls .claude/commands/ | grep sdd
 # 或
 ls .codex/prompts/ | grep sdd
+# 或
+ls .copilot/commands/ | grep sdd
 ```
 
 應該看到：
@@ -201,12 +233,19 @@ sdd-verify.md
 
 ### 快速模式（推薦）
 
+**Claude Code / Codex:**
 ```bash
 /sdd-auto Create a shopping cart in TypeScript with add, remove, and checkout functions
 ```
 
+**GitHub Copilot:**
+```bash
+@workspace /sdd-auto Create a shopping cart in TypeScript with add, remove, and checkout functions
+```
+
 ### 手動模式（逐步執行）
 
+**Claude Code / Codex:**
 ```bash
 # 步驟 1：定義規格
 /sdd-spec Create a shopping cart with add, remove, checkout
@@ -221,6 +260,21 @@ sdd-verify.md
 /sdd-verify features/shopping_cart.feature
 ```
 
+**GitHub Copilot:**
+```bash
+# 步驟 1：定義規格
+@workspace /sdd-spec Create a shopping cart with add, remove, checkout
+
+# 步驟 2：設計架構（審查 features/shopping_cart.feature 後）
+@workspace /sdd-arch features/shopping_cart.feature
+
+# 步驟 3：實作程式碼（審查 docs/ 後）
+@workspace /sdd-impl features/shopping_cart.feature
+
+# 步驟 4：驗證實作（審查 src/ 後）
+@workspace /sdd-verify features/shopping_cart.feature
+```
+
 ---
 
 ## 專案結構
@@ -249,6 +303,17 @@ sdd-verify.md
 └── sdd-verify.md
 ```
 
+**GitHub Copilot:**
+```
+~/.copilot/commands/
+├── sdd-auto.md
+├── sdd-spec.md
+├── sdd-arch.md
+├── sdd-integration-test.md
+├── sdd-impl.md
+└── sdd-verify.md
+```
+
 **您的專案保持乾淨，只有生成的程式碼:**
 ```
 your-project/

docs/PLATFORM_SUPPORT.md

@@ -9,31 +9,42 @@ GSI-Protocol 現在支援多個 AI 平台，讓您可以使用您偏好的 AI 
 ### Claude Code
 - **開發商：** Anthropic
 - **特色：** 強大的程式碼理解與生成能力
+- **指令格式：** `/sdd-*`
 - **指令目錄：** `~/.claude/commands/` (全域) 或 `.claude/commands/` (專案)
 - **狀態：** ✅ 完整支援
 
 ### Codex (OpenAI)
 - **開發商：** OpenAI
 - **特色：** 基於 GPT 技術的程式碼生成
+- **指令格式：** `/sdd-*`
 - **指令目錄：** `~/.codex/prompts/` (全域) 或 `.codex/prompts/` (專案)
 - **狀態：** ✅ 完整支援
 
+### GitHub Copilot
+- **開發商：** GitHub (Microsoft)
+- **特色：** 整合 VS Code 與 CLI 的 AI 程式輔助
+- **指令格式：** `@workspace /sdd-*`
+- **指令目錄：** `~/.copilot/commands/` (全域) 或 `.copilot/commands/` (專案)
+- **狀態：** ✅ 完整支援
+
 ---
 
 ## 📊 平台比較
 
-| 特性 | Claude Code | Codex (OpenAI) |
-|------|------------|----------------|
-| SDD 工作流程 | ✅ | ✅ |
-| Gherkin 規格生成 | ✅ | ✅ |
-| 架構設計 | ✅ | ✅ |
-| 程式碼實作 | ✅ | ✅ |
-| 驗證測試 | ✅ | ✅ |
-| 多語言支援 | ✅ | ✅ |
-| 框架無關 | ✅ | ✅ |
-| 專案感知 | ✅ | ✅ |
-
-**結論：** 兩個平台在 GSI-Protocol 工作流程中功能完全相同，選擇您偏好的平台即可。
+| 特性 | Claude Code | Codex (OpenAI) | GitHub Copilot |
+|------|------------|----------------|----------------|
+| SDD 工作流程 | ✅ | ✅ | ✅ |
+| Gherkin 規格生成 | ✅ | ✅ | ✅ |
+| 架構設計 | ✅ | ✅ | ✅ |
+| 程式碼實作 | ✅ | ✅ | ✅ |
+| 驗證測試 | ✅ | ✅ | ✅ |
+| 多語言支援 | ✅ | ✅ | ✅ |
+| 框架無關 | ✅ | ✅ | ✅ |
+| 專案感知 | ✅ | ✅ | ✅ |
+| 指令格式 | `/sdd-*` | `/sdd-*` | `@workspace /sdd-*` |
+| VS Code 整合 | - | - | ✅ |
+
+**結論：** 三個平台在 GSI-Protocol 工作流程中功能完全相同，選擇您偏好的平台即可。
 
 ---
 
@@ -44,14 +55,15 @@ GSI-Protocol 現在支援多個 AI 平台，讓您可以使用您偏好的 AI 
 **只用一個平台：**
 ```bash
 # 安裝時選擇您要使用的平台
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/install.sh | bash
-# 選擇選項 1 (Claude Code) 或 2 (Codex)
+uvx gsi-protocol-installer
+# 選擇選項 1 (Claude Code)、2 (Codex) 或 3 (GitHub Copilot)
 ```
 
-**同時使用兩個平台：**
+**同時使用多個平台：**
 ```bash
-# 安裝時選擇選項 3 (Both)
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/install.sh | bash
+# 安裝時可以選擇多個平台（用逗號分隔）
+uvx gsi-protocol-installer
+# 輸入 1,2,3 或 all 來安裝所有平台
 # 可以在不同專案中使用不同的 AI 工具
 ```
 
@@ -69,11 +81,16 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/in
 - 標準化程式碼生成
 - OpenAI 生態系整合
 
+### 何時使用 GitHub Copilot
+- VS Code 開發環境
+- CLI 工作流程整合
+- 需要 GitHub 生態系整合
+
 ### 混合使用
 您可以在同一專案中混合使用：
 - Phase 1-2 用 Claude Code（規格與架構）
-- Phase 3-4 用 Codex（實作與驗證）
-- 或反之
+- Phase 3-4 用 Copilot（實作與驗證）
+- 或任意組合
 
 ---
 
@@ -88,10 +105,25 @@ cd ~/.codex/prompts
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-auto.md -o sdd-auto.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-spec.md -o sdd-spec.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-arch.md -o sdd-arch.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-integration-test.md -o sdd-integration-test.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-impl.md -o sdd-impl.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-verify.md -o sdd-verify.md
 ```
 
+### 想加入 GitHub Copilot
+
+```bash
+# 全域安裝
+mkdir -p ~/.copilot/commands
+cd ~/.copilot/commands
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-auto.md -o sdd-auto.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-spec.md -o sdd-spec.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-arch.md -o sdd-arch.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-integration-test.md -o sdd-integration-test.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-impl.md -o sdd-impl.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.copilot/commands/sdd-verify.md -o sdd-verify.md
+```
+
 ### 已安裝 Codex，想加入 Claude Code
 
 ```bash
@@ -101,6 +133,7 @@ cd ~/.claude/commands
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-auto.md -o sdd-auto.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-spec.md -o sdd-spec.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-arch.md -o sdd-arch.md
+curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-integration-test.md -o sdd-integration-test.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-impl.md -o sdd-impl.md
 curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-verify.md -o sdd-verify.md
 ```
@@ -116,13 +149,23 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.c
 ├── sdd-auto.md
 ├── sdd-spec.md
 ├── sdd-arch.md
+├── sdd-integration-test.md
 ├── sdd-impl.md
 └── sdd-verify.md
 
 ~/.codex/prompts/          # Codex 全域 prompts
 ├── sdd-auto.md
 ├── sdd-spec.md
 ├── sdd-arch.md
+├── sdd-integration-test.md
+├── sdd-impl.md
+└── sdd-verify.md
+
+~/.copilot/commands/       # GitHub Copilot 全域指令
+├── sdd-auto.md
+├── sdd-spec.md
+├── sdd-arch.md
+├── sdd-integration-test.md
 ├── sdd-impl.md
 └── sdd-verify.md
 
@@ -139,6 +182,7 @@ your-project/
 your-project/
 ├── .claude/commands/      # Claude Code 專案指令（可選）
 ├── .codex/prompts/        # Codex 專案 prompts（可選）
+├── .copilot/commands/     # GitHub Copilot 專案指令（可選）
 ├── features/
 ├── docs/features/
 └── src/
@@ -150,22 +194,24 @@ your-project/
 
 ### Q: 指令內容有差異嗎？
 
-**A:** 有些許差異。兩個平台的**工作流程和輸出格式完全相同**，但指令格式略有不同：
+**A:** 有些許差異。三個平台的**工作流程和輸出格式完全相同**，但指令格式略有不同：
 
-- **Claude Code**: 使用 `{{prompt}}` 變數來接收參數
-- **Codex**: 使用 `argument-hint` 欄位和 `$1` 參數
+- **Claude Code**: 使用 `{{prompt}}` 變數，指令前綴為 `/sdd-*`
+- **Codex**: 使用 `{{prompt}}` 變數，指令前綴為 `/sdd-*`
+- **GitHub Copilot**: 使用 `{{ARG}}` 變數，指令前綴為 `@workspace /sdd-*`
 
 這些差異是為了符合各平台的技術規範，但不影響實際使用體驗。
 
-### Q: 可以同時安裝兩個平台嗎？
+### Q: 可以同時安裝多個平台嗎？
 
-**A:** 可以！您可以同時安裝，然後根據需求選擇使用哪個 AI 工具。
+**A:** 可以！您可以同時安裝所有三個平台，然後根據需求選擇使用哪個 AI 工具。
 
 ### Q: 哪個平台比較好？
 
-**A:** 兩者都很優秀，取決於您的偏好和使用情境：
+**A:** 三者都很優秀，取決於您的偏好和使用情境：
 - 如果您已經在使用 Claude Code → 繼續使用
 - 如果您偏好 OpenAI 生態系 → 使用 Codex
+- 如果您喜歡 VS Code 與 CLI 整合 → 使用 GitHub Copilot
 - 不確定 → 同時安裝，實際使用後再決定
 
 ### Q: 生成的檔案格式相容嗎？