fix: update python script

薛華慶, james.hsueh · 薛華慶, james.hsueh · commit 7fefd212275f · 2025-12-03T11:16:42.000+08:00
diff --git a/.codex/prompts/sdd-arch.md b/.codex/prompts/sdd-arch.md
@@ -1,11 +1,12 @@
 ---
 description: Phase 2 - 分析 Gherkin 規格，設計高階架構（資料模型與服務介面），輸出到 docs/features/{feature_name}/
+argument-hint: <feature_file_path>
 ---
 
 # SDD Phase 2: 架構設計
 
 **角色：** 系統架構師  
-**輸入：** Gherkin 規格檔案 {{prompt}}  
+**輸入：** Gherkin 規格檔案 $1  
 **輸出：** `docs/features/{feature_name}/architecture.md`
 
 ## 核心原則
diff --git a/.codex/prompts/sdd-auto.md b/.codex/prompts/sdd-auto.md
@@ -1,10 +1,11 @@
 ---
 description: 自動執行完整 SDD 工作流程 (4 Phases)
+argument-hint: <requirement_description>
 ---
 
 # SDD 自動模式
 
-**需求：** {{prompt}}
+**需求：** $1
 
 **目標：** 自動執行 Phase 1-4，從需求到驗證完成，無需手動介入
 
diff --git a/.codex/prompts/sdd-impl.md b/.codex/prompts/sdd-impl.md
@@ -1,11 +1,12 @@
 ---
 description: Phase 3 - 根據架構設計實作程式碼，滿足 Gherkin 規格
+argument-hint: <feature_file_path>
 ---
 
 # SDD Phase 3: 實作
 
 **角色：** 資深工程師  
-**輸入：** Gherkin 規格檔案 {{prompt}}  
+**輸入：** Gherkin 規格檔案 $1  
 **前置條件：** 已完成 Phase 2，存在 `docs/features/{feature_name}/architecture.md`  
 **輸出：** 實作程式碼於專案既有目錄結構
 
diff --git a/.codex/prompts/sdd-spec.md b/.codex/prompts/sdd-spec.md
@@ -1,5 +1,6 @@
 ---
 description: 階段 1 - 從使用者需求生成 Gherkin 行為規格（PM 角色）
+argument-hint: <requirement_description>
 ---
 
 # SDD 階段 1：需求規格（靈魂）
@@ -10,7 +11,7 @@ description: 階段 1 - 從使用者需求生成 Gherkin 行為規格（PM 角
 
 ## 使用者需求
 
-{{prompt}}
+$1
 
 ## 您的職責約束
 
diff --git a/.codex/prompts/sdd-verify.md b/.codex/prompts/sdd-verify.md
@@ -1,10 +1,11 @@
 ---
 description: Phase 4 - 驗證實作（QA 角色）
+argument-hint: <feature_file_path>
 ---
 
 # SDD Phase 4: 驗證
 
-**輸入：** {{prompt}} (Gherkin 檔案路徑)
+**輸入：** $1 (Gherkin 檔案路徑)
 
 **角色：** QA - 驗證實作符合 Gherkin 規格與架構設計，只報告不修改
 
diff --git a/CODEX_SUPPORT_CHANGELOG.md b/CODEX_SUPPORT_CHANGELOG.md
@@ -20,6 +20,8 @@ GSI-Protocol 現在支援 **Codex (OpenAI)**！除了原有的 Claude Code 支
 └── sdd-verify.md    # Phase 4: 驗證測試
 ```
 
+**注意：** Codex 的指令檔案實際上應放在 `.codex/prompts/` 目錄（已在最新版本中修正）。
+
 ### 2. 新增文檔
 - **`docs/PLATFORM_SUPPORT.md`** - 平台支援指南
   - Claude Code vs Codex 比較
@@ -149,9 +151,11 @@ your-project/
 ## 🔍 技術細節
 
 ### 指令內容
-- `.claude/commands/` 和 `.codex/commands/` 中的指令檔案內容**完全相同**
-- 只是放在不同目錄讓不同的 AI 工具讀取
-- 這確保了兩個平台有相同的工作流程和輸出格式
+- `.claude/commands/` 和 `.codex/commands/` 中的指令有些許格式差異：
+  - **Claude Code**: 使用 `{{prompt}}` 變數
+  - **Codex**: 使用 `argument-hint` 欄位和 `$1` 參數
+- 這些差異是為了符合各平台的技術規範
+- **工作流程和輸出格式完全相同**，確保兩個平台有相同的開發體驗
 
 ### 安裝腳本邏輯
 1. 先詢問用戶要安裝哪個平台
diff --git a/README.md b/README.md
@@ -79,13 +79,13 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.c
 
 **Codex (OpenAI):**
 ```bash
-mkdir -p ~/.codex/commands
-cd ~/.codex/commands
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-auto.md -o sdd-auto.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-spec.md -o sdd-spec.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-arch.md -o sdd-arch.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-impl.md -o sdd-impl.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-verify.md -o sdd-verify.md
+mkdir -p ~/.codex/prompts
+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-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
 ```
 
 完成後，可在任何專案中使用 `/sdd-auto`、`/sdd-spec` 等全域指令。
@@ -349,7 +349,7 @@ GSI-Protocol/
 │       ├── sdd-impl.md         # Phase 3
 │       └── sdd-verify.md       # Phase 4
 ├── .codex/
-│   └── commands/                # Codex (OpenAI) 指令
+│   └── prompts/                 # Codex (OpenAI) prompts
 │       ├── sdd-auto.md         # 自動工作流程
 │       ├── sdd-spec.md         # Phase 1
 │       ├── sdd-arch.md         # Phase 2
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
@@ -79,7 +79,7 @@ Enter choice [1-2] (default: 1): 2
 ℹ Downloading GSI-Protocol from GitHub...
 ✓ Downloaded successfully
 ✓ Installed 5 Claude Code commands to ~/.claude/commands
-✓ Installed 5 Codex commands to ~/.codex/commands
+✓ Installed 5 Codex commands to ~/.codex/prompts
 
 ============================================================
 ✓ Installation complete! Total files installed: 10
@@ -117,15 +117,15 @@ wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude
 
 **Codex (OpenAI):**
 ```bash
-mkdir -p ~/.codex/commands
-cd ~/.codex/commands
+mkdir -p ~/.codex/prompts
+cd ~/.codex/prompts
 
 # 下載所有指令檔案
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-auto.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-spec.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-arch.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-impl.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-verify.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-auto.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-spec.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-arch.md
+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
 ```
 
 ### 手動專案內安裝
@@ -142,16 +142,16 @@ wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude
 wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude/commands/sdd-verify.md
 
 # Codex
-mkdir -p .codex/commands
-cd .codex/commands
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-auto.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-spec.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-arch.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-impl.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-verify.md
+mkdir -p .codex/prompts
+cd .codex/prompts
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-auto.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-spec.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-arch.md
+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
 
 # 提交到 Git（可選）
-git add .claude/commands/ .codex/commands/
+git add .claude/commands/ .codex/prompts/
 git commit -m "Add GSI-Protocol workflow commands"
 ```
 
@@ -168,14 +168,14 @@ ls ~/.claude/commands/ | grep sdd
 
 **Codex (全域安裝):**
 ```bash
-ls ~/.codex/commands/ | grep sdd
+ls ~/.codex/prompts/ | grep sdd
 ```
 
 **專案內安裝:**
 ```bash
 ls .claude/commands/ | grep sdd
 # 或
-ls .codex/commands/ | grep sdd
+ls .codex/prompts/ | grep sdd
 ```
 
 應該看到：
@@ -241,7 +241,7 @@ sdd-verify.md
 
 **Codex (OpenAI):**
 ```
-~/.codex/commands/
+~/.codex/prompts/
 ├── sdd-auto.md
 ├── sdd-spec.md
 ├── sdd-arch.md
@@ -300,7 +300,7 @@ your-project/
 
 ### 推薦配置
 
-- ✅ **全域安裝**：`~/.claude/commands/` 或 `~/.codex/commands/` (所有專案共用)
+- ✅ **全域安裝**：`~/.claude/commands/` 或 `~/.codex/prompts/` (所有專案共用)
 - ✅ **專案目錄**：只有 `features/`、`docs/features/`、`src/`（生成的程式碼）
 - ❌ **不要**：把整個 GSI-Protocol repo clone 到專案裡
 
@@ -316,9 +316,9 @@ your-project/
 **方式 2：專案內只包含 commands（Git 管理）**
 ```bash
 # 在專案內安裝並 commit
-mkdir -p .claude/commands .codex/commands
+mkdir -p .claude/commands .codex/prompts
 # 複製命令檔案...
-git add .claude/commands/ .codex/commands/
+git add .claude/commands/ .codex/prompts/
 git commit -m "Add SDD workflow commands"
 ```
 
@@ -347,7 +347,7 @@ rm -f ~/.claude/commands/sdd-*.md
 
 **Codex (OpenAI):**
 ```bash
-rm -f ~/.codex/commands/sdd-*.md
+rm -f ~/.codex/prompts/sdd-*.md
 ```
 
 ### 專案內安裝
@@ -361,7 +361,7 @@ rm -rf .claude/
 
 **Codex (OpenAI):**
 ```bash
-rm -rf .codex/commands/sdd-*.md
+rm -rf .codex/prompts/sdd-*.md
 # 或整個目錄
 rm -rf .codex/
 ```
@@ -384,7 +384,7 @@ rm -rf .codex/
 
 **A：** 取決於您的 AI 工具：
 - 如果使用 Claude Code → 安裝 `.claude/commands/`
-- 如果使用 Codex (OpenAI) → 安裝 `.codex/commands/`
+- 如果使用 Codex (OpenAI) → 安裝 `.codex/prompts/`
 - 可以同時安裝兩者，隨時切換使用
 
 ### Q：Claude Code 和 Codex 的指令內容有差異嗎？
@@ -413,8 +413,8 @@ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
 ### Q：全域安裝和專案內安裝有什麼區別？
 
 **A：**
-- **全域**：`~/.claude/commands/` 或 `~/.codex/commands/`，所有專案共用，專案保持乾淨
-- **專案內**：`.claude/commands/` 或 `.codex/commands/`，指令隨專案走，團隊成員 clone 後就有
+- **全域**：`~/.claude/commands/` 或 `~/.codex/prompts/`，所有專案共用，專案保持乾淨
+- **專案內**：`.claude/commands/` 或 `.codex/prompts/`，指令隨專案走，團隊成員 clone 後就有
 
 ### Q：團隊成員需要每個人都安裝嗎？
 
@@ -454,12 +454,12 @@ wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.claude
 
 **手動全域安裝 - Codex (OpenAI)：**
 ```bash
-mkdir -p ~/.codex/commands && cd ~/.codex/commands
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-auto.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-spec.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-arch.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-impl.md
-wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-verify.md
+mkdir -p ~/.codex/prompts && cd ~/.codex/prompts
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-auto.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-spec.md
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/prompts/sdd-arch.md
+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
 ```
 
 開始使用 GSI-Protocol，讓 AI 幫您寫結構化的程式碼！🚀
diff --git a/docs/PLATFORM_SUPPORT.md b/docs/PLATFORM_SUPPORT.md
@@ -15,7 +15,7 @@ GSI-Protocol 現在支援多個 AI 平台，讓您可以使用您偏好的 AI 
 ### Codex (OpenAI)
 - **開發商：** OpenAI
 - **特色：** 基於 GPT 技術的程式碼生成
-- **指令目錄：** `~/.codex/commands/` (全域) 或 `.codex/commands/` (專案)
+- **指令目錄：** `~/.codex/prompts/` (全域) 或 `.codex/prompts/` (專案)
 - **狀態：** ✅ 完整支援
 
 ---
@@ -83,13 +83,13 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/in
 
 ```bash
 # 全域安裝
-mkdir -p ~/.codex/commands
-cd ~/.codex/commands
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-auto.md -o sdd-auto.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-spec.md -o sdd-spec.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-arch.md -o sdd-arch.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-impl.md -o sdd-impl.md
-curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.codex/commands/sdd-verify.md -o sdd-verify.md
+mkdir -p ~/.codex/prompts
+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-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
 ```
 
 ### 已安裝 Codex，想加入 Claude Code
@@ -119,7 +119,7 @@ curl -sSL https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/.c
 ├── sdd-impl.md
 └── sdd-verify.md
 
-~/.codex/commands/         # Codex 全域指令
+~/.codex/prompts/          # Codex 全域 prompts
 ├── sdd-auto.md
 ├── sdd-spec.md
 ├── sdd-arch.md
@@ -138,7 +138,7 @@ your-project/
 ```
 your-project/
 ├── .claude/commands/      # Claude Code 專案指令（可選）
-├── .codex/commands/       # Codex 專案指令（可選）
+├── .codex/prompts/        # Codex 專案 prompts（可選）
 ├── features/
 ├── docs/features/
 └── src/
@@ -150,7 +150,12 @@ your-project/
 
 ### Q: 指令內容有差異嗎？
 
-**A:** 沒有，`.claude/commands/` 和 `.codex/commands/` 中的指令檔案內容完全相同。只是放在不同目錄讓不同的 AI 工具讀取。
+**A:** 有些許差異。兩個平台的**工作流程和輸出格式完全相同**，但指令格式略有不同：
+
+- **Claude Code**: 使用 `{{prompt}}` 變數來接收參數
+- **Codex**: 使用 `argument-hint` 欄位和 `$1` 參數
+
+這些差異是為了符合各平台的技術規範，但不影響實際使用體驗。
 
 ### Q: 可以同時安裝兩個平台嗎？
 
diff --git a/docs/PYTHON_INSTALLER.md b/docs/PYTHON_INSTALLER.md
@@ -87,7 +87,7 @@ Enter choice [1-2] (default: 1): 2
 ℹ Downloading GSI-Protocol from GitHub...
 ✓ Downloaded successfully
 ✓ Installed 5 Claude Code commands to ~/.claude/commands
-✓ Installed 5 Codex commands to ~/.codex/commands
+✓ Installed 5 Codex commands to ~/.codex/prompts
 
 ============================================================
 ✓ Installation complete! Total files installed: 10
@@ -238,11 +238,11 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 ```bash
 # 全域安裝
 rm -rf ~/.claude/commands/sdd-*
-rm -rf ~/.codex/commands/sdd-*
+rm -rf ~/.codex/prompts/sdd-*
 
 # 專案安裝
 rm -rf .claude/commands/sdd-*
-rm -rf .codex/commands/sdd-*
+rm -rf .codex/prompts/sdd-*
 ```
 
 ## 📖 相關文件
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md
diff --git a/gsi_installer.py b/gsi_installer.py
