gsi-protocol-installer 1.0.2__tar.gz

gsi_protocol_installer-1.0.2/.gitignore

@@ -0,0 +1,74 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+venv/
+ENV/
+env/
+.venv
+
+# PyPI (important!)
+.pypirc
+!.pypirc.example
+
+# TypeScript / JavaScript
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.eslintcache
+*.tsbuildinfo
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+*.cover
+
+# Generated files during workflow
+features/*.generated.*
+structure/*.generated.*
+implementation/*.generated.*
+verification/*.generated.*
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Virtual environments for testing
+test_env/
+

gsi_protocol_installer-1.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 James 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gsi_protocol_installer-1.0.2/MANIFEST.in

@@ -0,0 +1,12 @@
+# Include essential files
+include LICENSE
+include README.md
+include pyproject.toml
+include gsi_installer.py
+
+# Exclude unnecessary files
+exclude .gitignore
+exclude .git
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .DS_Store

gsi_protocol_installer-1.0.2/PKG-INFO

@@ -0,0 +1,488 @@
+Metadata-Version: 2.4
+Name: gsi-protocol-installer
+Version: 1.0.2
+Summary: Installer for GSI-Protocol workflow commands (Claude Code & Codex)
+Project-URL: Homepage, https://github.com/CodeMachine0121/GSI-Protocol
+Project-URL: Documentation, https://github.com/CodeMachine0121/GSI-Protocol/blob/main/README.md
+Project-URL: Repository, https://github.com/CodeMachine0121/GSI-Protocol
+Project-URL: Issues, https://github.com/CodeMachine0121/GSI-Protocol/issues
+Project-URL: Changelog, https://github.com/CodeMachine0121/GSI-Protocol/blob/main/CODEX_SUPPORT_CHANGELOG.md
+Author-email: James Hsueh <asdfg55887@gmail.com>
+Maintainer: GSI-Protocol Contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,bdd,claude,codex,gherkin,gsi-protocol,sdd,spec-driven-development,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# GSI-Protocol（中文）
+
+> **Gherkin → 架構 → 實作**
+>
+> 一個語言無關的工作流程，使用 AI 代理和 BDD 原則建立可驗證的軟體功能。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🎯 什麼是 GSI-Protocol?
+
+GSI-Protocol 是一個 AI 驅動的工作流程插件，實作了**規格驅動開發（SDD）**。它透過嚴格的四階段流程，將模糊的需求轉化為經過驗證、可用於生產環境的程式碼。
+
+**支援平台：**
+- ✅ Claude Code
+- ✅ Codex (OpenAI)
+
+### 核心理念
+
+**"規格 → 架構 → 實作 → 驗證"**
+
+將業務邏輯、技術架構、程式撰寫和品質保證分離到不同階段，以最小化 AI 幻覺並最大化精確度。
+
+### 主要特性
+
+- 🌍 **語言無關**：支援 Python、TypeScript、Go、Java、Rust、C# 等等
+- 🎯 **框架獨立**：不綁定任何特定函式庫或框架
+- 📝 **基於 BDD**：使用 Gherkin 撰寫清晰、可測試的規格
+- 🏗️ **專案感知**：自動掃描並遵循既有專案架構
+- ✅ **可驗證**：自動根據規格進行驗證
+- 🔄 **模組化**：可獨立執行各階段或完整工作流程
+
+---
+
+## 📦 快速開始
+
+### 安裝
+
+**選項 1：使用 uvx（最推薦，無需安裝）**
+
+```bash
+uvx gsi-protocol-installer
+```
+
+**選項 2：使用 pipx**
+
+```bash
+pipx run gsi-protocol-installer
+```
+
+**選項 3：直接執行 Python**
+
+```bash
+# 下載並執行
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/gsi_installer.py
+python3 gsi_installer.py
+
+# 或使用 curl
+curl -O https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/gsi_installer.py
+python3 gsi_installer.py
+```
+
+安裝程式會引導您：
+1. 選擇 AI 平台（Claude Code、Codex 或兩者）
+2. 選擇安裝位置（全域或當前專案）
+3. 自動完成安裝
+
+**選項 4：手動全域安裝**
+
+**Claude Code:**
+```bash
+mkdir -p ~/.claude/commands
+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-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
+```
+
+**Codex (OpenAI):**
+```bash
+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` 等全域指令。
+
+> 📖 查看 [安裝指南](docs/INSTALL.md) 了解詳細說明
+
+### 第一次使用（2 分鐘）
+
+```bash
+# 使用 uvx 安裝
+uvx gsi-protocol-installer
+
+# 選擇平台和安裝位置後，進入您的專案
+cd your-project
+
+# 自動模式 - 生成所有內容
+/sdd-auto Create a shopping cart in TypeScript with add, remove, checkout functions
+
+# 手動模式 - 逐步執行
+/sdd-spec Create a shopping cart with add, remove, checkout
+/sdd-arch features/shopping_cart.feature
+/sdd-impl features/shopping_cart.feature
+/sdd-verify features/shopping_cart.feature
+```
+
+---
+
+## 📚 文件
+
+| 文件 | 說明 |
+|----------|-------------|
+| **[快速入門指南](docs/QUICKSTART.md)** | 5 分鐘教學 |
+| **[安裝指南](docs/INSTALL.md)** | 詳細安裝說明 |
+| **[Python 安裝器](docs/PYTHON_INSTALLER.md)** | uvx 安裝方式（推薦） |
+| **[平台支援](docs/PLATFORM_SUPPORT.md)** | Claude Code vs Codex 比較 |
+| **[指令參考](docs/COMMANDS.md)** | 完整指令文件 |
+| **[語言指南](docs/LANGUAGE_GUIDE.md)** | 多語言支援指南 |
+| **[工作流程定義](docs/expected_workflow.md)** | 詳細方法論 |
+| **[貢獻指南](CONTRIBUTING.md)** | 如何貢獻 |
+
+---
+
+## 🔄 工作流程概覽
+
+### 四個階段
+
+```
+Phase 1：規格（PM）
+    ↓
+    Gherkin .feature 檔案
+    ↓
+Phase 2：架構（架構師）
+    ↓
+    架構設計文件（繁中 Markdown）
+    ↓
+Phase 3：實作（工程師）
+    ↓
+    可運行的程式碼（依專案架構）
+    ↓
+Phase 4：驗證（QA）
+    ↓
+    ✅ 驗證結論報告
+```
+
+### 指令
+
+| 指令 | 用途 | 何時使用 |
+|---------|---------|-------------|
+| `/sdd-auto` | 自動執行全部 4 個階段 | 快速原型、簡單功能 |
+| `/sdd-spec` | 生成 Gherkin 規格 | 定義需求 |
+| `/sdd-arch` | 設計資料模型與介面 | 審查結構 |
+| `/sdd-impl` | 實作邏輯 | 撰寫程式碼 |
+| `/sdd-verify` | 根據規格驗證 | 測試實作 |
+
+---
+
+## 💡 範例
+
+### 輸入
+
+```
+/sdd-auto Implement a VIP discount system in Python where VIP users get 20% off purchases over $100
+```
+
+### 輸出
+
+**階段 1：規格** (`features/vip_discount.feature`)
+```gherkin
+Feature: VIP Discount
+  Scenario: Apply discount to VIP user
+    Given user is VIP
+    When user makes a purchase of 1000 USD
+    Then final price should be 800 USD
+```
+
+**Phase 2：架構** (`docs/features/vip_discount/architecture.md`)
+```markdown
+# VIP 折扣系統 - 架構設計
+
+## 1. 專案上下文
+- 程式語言：Python
+- 架構模式：Service Layer
+
+## 3. 資料模型
+- UserType（列舉）：VIP, NORMAL
+- DiscountResult（實體）：final_price, discount
+
+## 4. 服務介面
+- calculate_discount(amount, user_type) → DiscountResult
+```
+
+**Phase 3：實作** （依 architecture.md 指定位置）
+```python
+# src/services/discount_service.py
+def calculate_discount(amount: float, user_type: UserType) -> DiscountResult:
+    if user_type == UserType.VIP and amount >= 100:
+        discount = amount * 0.2
+        return DiscountResult(amount - discount, discount)
+    return DiscountResult(amount, 0)
+```
+
+**Phase 4：驗證結論** (`docs/features/vip_discount/conclusion.md`)
+```markdown
+## 3. 摘要
+- 架構：2/2 通過
+- 情境：2/2 通過
+- **狀態：** ✅ 完成
+```
+
+---
+
+## 🌐 多語言支援
+
+相同的工作流程，不同的語言：
+
+<details>
+<summary><b>Python</b></summary>
+
+```python
+from dataclasses import dataclass
+from abc import ABC, abstractmethod
+
+@dataclass
+class User:
+    id: str
+    type: UserType
+
+class IUserService(ABC):
+    @abstractmethod
+    def authenticate(self, credentials: Credentials) -> User:
+        pass
+```
+</details>
+
+<details>
+<summary><b>TypeScript</b></summary>
+
+```typescript
+interface User {
+  id: string;
+  type: UserType;
+}
+
+interface IUserService {
+  authenticate(credentials: Credentials): User;
+}
+```
+</details>
+
+<details>
+<summary><b>Go</b></summary>
+
+```go
+type User struct {
+    ID   string
+    Type UserType
+}
+
+type UserService interface {
+    Authenticate(credentials Credentials) (User, error)
+}
+```
+</details>
+
+更多語言請參閱 [語言指南](docs/LANGUAGE_GUIDE.md)，包含 Rust、Java、C# 等。
+
+---
+
+## 🎓 使用案例
+
+### 1. API 開發
+```bash
+/sdd-spec Design a RESTful API for blog posts (CRUD operations)
+/sdd-arch features/blog_api.feature
+# 獲得清晰的 API 契約和資料結構
+```
+
+### 2. 功能實作
+```bash
+/sdd-auto Implement user authentication with JWT tokens in TypeScript
+# 幾分鐘內獲得可運行、已測試的程式碼
+```
+
+### 3. 遺留程式碼重構
+```bash
+/sdd-spec The payment module should support credit card, PayPal, and crypto
+# 在重構前定義清晰的需求
+```
+
+### 4. 團隊協作
+```bash
+# PM：定義需求
+/sdd-spec User registration with email verification
+
+# 架構師：審查並設計
+/sdd-arch features/user_registration.feature
+
+# 工程師：實作
+/sdd-impl features/user_registration.feature
+
+# QA：驗證
+/sdd-verify features/user_registration.feature
+```
+
+---
+
+## 📁 專案結構
+
+執行 SDD 工作流程後的輸出：
+
+```
+your-project/
+├── features/                    # Phase 1: Gherkin 規格
+│   └── {feature}.feature
+├── docs/
+│   └── features/
+│       └── {feature}/
+│           ├── architecture.md  # Phase 2: 架構設計（繁中）
+│           └── conclusion.md    # Phase 4: 驗證結論
+└── src/                         # Phase 3: 實作程式碼
+    ├── models/                  # 依專案既有架構
+    │   └── {Feature}Model.{ext}
+    └── services/
+        └── {Feature}Service.{ext}
+```
+
+GSI-Protocol 儲存庫結構：
+
+```
+GSI-Protocol/
+├── README.md                    # 本檔案
+├── CONTRIBUTING.md              # 貢獻指南
+├── LICENSE                      # MIT 授權
+├── gsi_installer.py             # Python 安裝器
+├── pyproject.toml               # Python 專案配置
+├── .claude/
+│   └── commands/                # Claude Code slash 指令
+│       ├── sdd-auto.md         # 自動工作流程
+│       ├── sdd-spec.md         # Phase 1
+│       ├── sdd-arch.md         # Phase 2
+│       ├── sdd-impl.md         # Phase 3
+│       └── sdd-verify.md       # Phase 4
+├── .codex/
+│   └── prompts/                 # Codex (OpenAI) prompts
+│       ├── sdd-auto.md         # 自動工作流程
+│       ├── sdd-spec.md         # Phase 1
+│       ├── sdd-arch.md         # Phase 2
+│       ├── sdd-impl.md         # Phase 3
+│       └── sdd-verify.md       # Phase 4
+├── docs/                        # 文件
+│   ├── QUICKSTART.md           # 快速入門指南
+│   ├── INSTALL.md              # 安裝指南
+│   ├── PYTHON_INSTALLER.md     # Python 安裝器說明
+│   ├── PLATFORM_SUPPORT.md     # 平台支援說明
+│   ├── COMMANDS.md             # 指令參考
+│   ├── LANGUAGE_GUIDE.md       # 語言支援
+│   └── expected_workflow.md    # 工作流程細節
+└── prompts/                     # 代理提示（參考）
+    ├── pm_agent.md
+    ├── architect_agent.md
+    ├── engineer_agent.md
+    └── qa_agent.md
+```
+
+---
+
+## 🚀 優勢
+
+### 對開發者
+- ✅ **更快開發**：自動生成樣板程式碼和結構
+- ✅ **更高品質**：系統化方法減少 bug
+- ✅ **清晰需求**：Gherkin 規格消除歧義
+
+### 對團隊
+- ✅ **共同語言**：所有人都能理解的 BDD 規格
+- ✅ **更好溝通**：PM、架構師、工程師、QA 各有明確階段
+- ✅ **可維護程式碼**：每一行都可追溯到需求
+
+### 對專案
+- ✅ **語言彈性**：切換語言不需改變方法論
+- ✅ **框架無關**：使用任何函式庫或框架
+- ✅ **可擴展**：適用於簡單功能到複雜系統
+
+---
+
+## 🔧 需求
+
+- **AI 平台（擇一或兩者）：**
+  - Claude Code CLI，或
+  - Codex (OpenAI)
+- **安裝工具：**
+  - Python 3.10+
+  - uvx/pipx（推薦）或 pip
+- Git
+- 目標語言執行環境（Python 3.8+、Node.js 16+、Go 1.19+ 等）
+
+---
+
+## 📖 了解更多
+
+- 📝 [快速入門（5 分鐘）](docs/QUICKSTART.md)
+- 📚 [完整文件](docs/)
+- 🌍 [語言支援](docs/LANGUAGE_GUIDE.md)
+- 💬 [GitHub 討論](https://github.com/CodeMachine0121/GSI-Protocol/discussions)
+
+---
+
+## 🤝 貢獻
+
+我們歡迎貢獻！請參閱 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
+
+### 貢獻方式
+- 🐛 回報 bug
+- 💡 建議功能
+- 📝 改善文件
+- 🌍 新增語言範例
+- 🔧 提交 pull request
+
+---
+
+## 📄 授權
+
+MIT 授權 - 詳見 [LICENSE](LICENSE) 檔案。
+
+---
+
+## 🙏 致謝
+
+使用以下工具建置：
+- [Claude Code](https://claude.ai/claude-code) - AI 驅動開發
+- [Codex (OpenAI)](https://openai.com/blog/openai-codex) - AI 程式碼生成
+- [Gherkin](https://cucumber.io/docs/gherkin/) - BDD 規格語言
+- 靈感來自測試驅動開發和行為驅動開發原則
+
+---
+
+## 📞 支援
+
+- 📖 [文件](docs/)
+- 💬 [GitHub Issues](https://github.com/CodeMachine0121/GSI-Protocol/issues)
+- 💡 [討論](https://github.com/CodeMachine0121/GSI-Protocol/discussions)
+
+---
+
+<div align="center">
+
+**[⬆ 回到頂端](#gsi-protocol中文)**
+
+由開發者打造，為開發者服務 ❤️
+
+</div>

gsi_protocol_installer-1.0.2/README.md

@@ -0,0 +1,459 @@
+# GSI-Protocol（中文）
+
+> **Gherkin → 架構 → 實作**
+>
+> 一個語言無關的工作流程，使用 AI 代理和 BDD 原則建立可驗證的軟體功能。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🎯 什麼是 GSI-Protocol?
+
+GSI-Protocol 是一個 AI 驅動的工作流程插件，實作了**規格驅動開發（SDD）**。它透過嚴格的四階段流程，將模糊的需求轉化為經過驗證、可用於生產環境的程式碼。
+
+**支援平台：**
+- ✅ Claude Code
+- ✅ Codex (OpenAI)
+
+### 核心理念
+
+**"規格 → 架構 → 實作 → 驗證"**
+
+將業務邏輯、技術架構、程式撰寫和品質保證分離到不同階段，以最小化 AI 幻覺並最大化精確度。
+
+### 主要特性
+
+- 🌍 **語言無關**：支援 Python、TypeScript、Go、Java、Rust、C# 等等
+- 🎯 **框架獨立**：不綁定任何特定函式庫或框架
+- 📝 **基於 BDD**：使用 Gherkin 撰寫清晰、可測試的規格
+- 🏗️ **專案感知**：自動掃描並遵循既有專案架構
+- ✅ **可驗證**：自動根據規格進行驗證
+- 🔄 **模組化**：可獨立執行各階段或完整工作流程
+
+---
+
+## 📦 快速開始
+
+### 安裝
+
+**選項 1：使用 uvx（最推薦，無需安裝）**
+
+```bash
+uvx gsi-protocol-installer
+```
+
+**選項 2：使用 pipx**
+
+```bash
+pipx run gsi-protocol-installer
+```
+
+**選項 3：直接執行 Python**
+
+```bash
+# 下載並執行
+wget https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/gsi_installer.py
+python3 gsi_installer.py
+
+# 或使用 curl
+curl -O https://raw.githubusercontent.com/CodeMachine0121/GSI-Protocol/main/gsi_installer.py
+python3 gsi_installer.py
+```
+
+安裝程式會引導您：
+1. 選擇 AI 平台（Claude Code、Codex 或兩者）
+2. 選擇安裝位置（全域或當前專案）
+3. 自動完成安裝
+
+**選項 4：手動全域安裝**
+
+**Claude Code:**
+```bash
+mkdir -p ~/.claude/commands
+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-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
+```
+
+**Codex (OpenAI):**
+```bash
+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` 等全域指令。
+
+> 📖 查看 [安裝指南](docs/INSTALL.md) 了解詳細說明
+
+### 第一次使用（2 分鐘）
+
+```bash
+# 使用 uvx 安裝
+uvx gsi-protocol-installer
+
+# 選擇平台和安裝位置後，進入您的專案
+cd your-project
+
+# 自動模式 - 生成所有內容
+/sdd-auto Create a shopping cart in TypeScript with add, remove, checkout functions
+
+# 手動模式 - 逐步執行
+/sdd-spec Create a shopping cart with add, remove, checkout
+/sdd-arch features/shopping_cart.feature
+/sdd-impl features/shopping_cart.feature
+/sdd-verify features/shopping_cart.feature
+```
+
+---
+
+## 📚 文件
+
+| 文件 | 說明 |
+|----------|-------------|
+| **[快速入門指南](docs/QUICKSTART.md)** | 5 分鐘教學 |
+| **[安裝指南](docs/INSTALL.md)** | 詳細安裝說明 |
+| **[Python 安裝器](docs/PYTHON_INSTALLER.md)** | uvx 安裝方式（推薦） |
+| **[平台支援](docs/PLATFORM_SUPPORT.md)** | Claude Code vs Codex 比較 |
+| **[指令參考](docs/COMMANDS.md)** | 完整指令文件 |
+| **[語言指南](docs/LANGUAGE_GUIDE.md)** | 多語言支援指南 |
+| **[工作流程定義](docs/expected_workflow.md)** | 詳細方法論 |
+| **[貢獻指南](CONTRIBUTING.md)** | 如何貢獻 |
+
+---
+
+## 🔄 工作流程概覽
+
+### 四個階段
+
+```
+Phase 1：規格（PM）
+    ↓
+    Gherkin .feature 檔案
+    ↓
+Phase 2：架構（架構師）
+    ↓
+    架構設計文件（繁中 Markdown）
+    ↓
+Phase 3：實作（工程師）
+    ↓
+    可運行的程式碼（依專案架構）
+    ↓
+Phase 4：驗證（QA）
+    ↓
+    ✅ 驗證結論報告
+```
+
+### 指令
+
+| 指令 | 用途 | 何時使用 |
+|---------|---------|-------------|
+| `/sdd-auto` | 自動執行全部 4 個階段 | 快速原型、簡單功能 |
+| `/sdd-spec` | 生成 Gherkin 規格 | 定義需求 |
+| `/sdd-arch` | 設計資料模型與介面 | 審查結構 |
+| `/sdd-impl` | 實作邏輯 | 撰寫程式碼 |
+| `/sdd-verify` | 根據規格驗證 | 測試實作 |
+
+---
+
+## 💡 範例
+
+### 輸入
+
+```
+/sdd-auto Implement a VIP discount system in Python where VIP users get 20% off purchases over $100
+```
+
+### 輸出
+
+**階段 1：規格** (`features/vip_discount.feature`)
+```gherkin
+Feature: VIP Discount
+  Scenario: Apply discount to VIP user
+    Given user is VIP
+    When user makes a purchase of 1000 USD
+    Then final price should be 800 USD
+```
+
+**Phase 2：架構** (`docs/features/vip_discount/architecture.md`)
+```markdown
+# VIP 折扣系統 - 架構設計
+
+## 1. 專案上下文
+- 程式語言：Python
+- 架構模式：Service Layer
+
+## 3. 資料模型
+- UserType（列舉）：VIP, NORMAL
+- DiscountResult（實體）：final_price, discount
+
+## 4. 服務介面
+- calculate_discount(amount, user_type) → DiscountResult
+```
+
+**Phase 3：實作** （依 architecture.md 指定位置）
+```python
+# src/services/discount_service.py
+def calculate_discount(amount: float, user_type: UserType) -> DiscountResult:
+    if user_type == UserType.VIP and amount >= 100:
+        discount = amount * 0.2
+        return DiscountResult(amount - discount, discount)
+    return DiscountResult(amount, 0)
+```
+
+**Phase 4：驗證結論** (`docs/features/vip_discount/conclusion.md`)
+```markdown
+## 3. 摘要
+- 架構：2/2 通過
+- 情境：2/2 通過
+- **狀態：** ✅ 完成
+```
+
+---
+
+## 🌐 多語言支援
+
+相同的工作流程，不同的語言：
+
+<details>
+<summary><b>Python</b></summary>
+
+```python
+from dataclasses import dataclass
+from abc import ABC, abstractmethod
+
+@dataclass
+class User:
+    id: str
+    type: UserType
+
+class IUserService(ABC):
+    @abstractmethod
+    def authenticate(self, credentials: Credentials) -> User:
+        pass
+```
+</details>
+
+<details>
+<summary><b>TypeScript</b></summary>
+
+```typescript
+interface User {
+  id: string;
+  type: UserType;
+}
+
+interface IUserService {
+  authenticate(credentials: Credentials): User;
+}
+```
+</details>
+
+<details>
+<summary><b>Go</b></summary>
+
+```go
+type User struct {
+    ID   string
+    Type UserType
+}
+
+type UserService interface {
+    Authenticate(credentials Credentials) (User, error)
+}
+```
+</details>
+
+更多語言請參閱 [語言指南](docs/LANGUAGE_GUIDE.md)，包含 Rust、Java、C# 等。
+
+---
+
+## 🎓 使用案例
+
+### 1. API 開發
+```bash
+/sdd-spec Design a RESTful API for blog posts (CRUD operations)
+/sdd-arch features/blog_api.feature
+# 獲得清晰的 API 契約和資料結構
+```
+
+### 2. 功能實作
+```bash
+/sdd-auto Implement user authentication with JWT tokens in TypeScript
+# 幾分鐘內獲得可運行、已測試的程式碼
+```
+
+### 3. 遺留程式碼重構
+```bash
+/sdd-spec The payment module should support credit card, PayPal, and crypto
+# 在重構前定義清晰的需求
+```
+
+### 4. 團隊協作
+```bash
+# PM：定義需求
+/sdd-spec User registration with email verification
+
+# 架構師：審查並設計
+/sdd-arch features/user_registration.feature
+
+# 工程師：實作
+/sdd-impl features/user_registration.feature
+
+# QA：驗證
+/sdd-verify features/user_registration.feature
+```
+
+---
+
+## 📁 專案結構
+
+執行 SDD 工作流程後的輸出：
+
+```
+your-project/
+├── features/                    # Phase 1: Gherkin 規格
+│   └── {feature}.feature
+├── docs/
+│   └── features/
+│       └── {feature}/
+│           ├── architecture.md  # Phase 2: 架構設計（繁中）
+│           └── conclusion.md    # Phase 4: 驗證結論
+└── src/                         # Phase 3: 實作程式碼
+    ├── models/                  # 依專案既有架構
+    │   └── {Feature}Model.{ext}
+    └── services/
+        └── {Feature}Service.{ext}
+```
+
+GSI-Protocol 儲存庫結構：
+
+```
+GSI-Protocol/
+├── README.md                    # 本檔案
+├── CONTRIBUTING.md              # 貢獻指南
+├── LICENSE                      # MIT 授權
+├── gsi_installer.py             # Python 安裝器
+├── pyproject.toml               # Python 專案配置
+├── .claude/
+│   └── commands/                # Claude Code slash 指令
+│       ├── sdd-auto.md         # 自動工作流程
+│       ├── sdd-spec.md         # Phase 1
+│       ├── sdd-arch.md         # Phase 2
+│       ├── sdd-impl.md         # Phase 3
+│       └── sdd-verify.md       # Phase 4
+├── .codex/
+│   └── prompts/                 # Codex (OpenAI) prompts
+│       ├── sdd-auto.md         # 自動工作流程
+│       ├── sdd-spec.md         # Phase 1
+│       ├── sdd-arch.md         # Phase 2
+│       ├── sdd-impl.md         # Phase 3
+│       └── sdd-verify.md       # Phase 4
+├── docs/                        # 文件
+│   ├── QUICKSTART.md           # 快速入門指南
+│   ├── INSTALL.md              # 安裝指南
+│   ├── PYTHON_INSTALLER.md     # Python 安裝器說明
+│   ├── PLATFORM_SUPPORT.md     # 平台支援說明
+│   ├── COMMANDS.md             # 指令參考
+│   ├── LANGUAGE_GUIDE.md       # 語言支援
+│   └── expected_workflow.md    # 工作流程細節
+└── prompts/                     # 代理提示（參考）
+    ├── pm_agent.md
+    ├── architect_agent.md
+    ├── engineer_agent.md
+    └── qa_agent.md
+```
+
+---
+
+## 🚀 優勢
+
+### 對開發者
+- ✅ **更快開發**：自動生成樣板程式碼和結構
+- ✅ **更高品質**：系統化方法減少 bug
+- ✅ **清晰需求**：Gherkin 規格消除歧義
+
+### 對團隊
+- ✅ **共同語言**：所有人都能理解的 BDD 規格
+- ✅ **更好溝通**：PM、架構師、工程師、QA 各有明確階段
+- ✅ **可維護程式碼**：每一行都可追溯到需求
+
+### 對專案
+- ✅ **語言彈性**：切換語言不需改變方法論
+- ✅ **框架無關**：使用任何函式庫或框架
+- ✅ **可擴展**：適用於簡單功能到複雜系統
+
+---
+
+## 🔧 需求
+
+- **AI 平台（擇一或兩者）：**
+  - Claude Code CLI，或
+  - Codex (OpenAI)
+- **安裝工具：**
+  - Python 3.10+
+  - uvx/pipx（推薦）或 pip
+- Git
+- 目標語言執行環境（Python 3.8+、Node.js 16+、Go 1.19+ 等）
+
+---
+
+## 📖 了解更多
+
+- 📝 [快速入門（5 分鐘）](docs/QUICKSTART.md)
+- 📚 [完整文件](docs/)
+- 🌍 [語言支援](docs/LANGUAGE_GUIDE.md)
+- 💬 [GitHub 討論](https://github.com/CodeMachine0121/GSI-Protocol/discussions)
+
+---
+
+## 🤝 貢獻
+
+我們歡迎貢獻！請參閱 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
+
+### 貢獻方式
+- 🐛 回報 bug
+- 💡 建議功能
+- 📝 改善文件
+- 🌍 新增語言範例
+- 🔧 提交 pull request
+
+---
+
+## 📄 授權
+
+MIT 授權 - 詳見 [LICENSE](LICENSE) 檔案。
+
+---
+
+## 🙏 致謝
+
+使用以下工具建置：
+- [Claude Code](https://claude.ai/claude-code) - AI 驅動開發
+- [Codex (OpenAI)](https://openai.com/blog/openai-codex) - AI 程式碼生成
+- [Gherkin](https://cucumber.io/docs/gherkin/) - BDD 規格語言
+- 靈感來自測試驅動開發和行為驅動開發原則
+
+---
+
+## 📞 支援
+
+- 📖 [文件](docs/)
+- 💬 [GitHub Issues](https://github.com/CodeMachine0121/GSI-Protocol/issues)
+- 💡 [討論](https://github.com/CodeMachine0121/GSI-Protocol/discussions)
+
+---
+
+<div align="center">
+
+**[⬆ 回到頂端](#gsi-protocol中文)**
+
+由開發者打造，為開發者服務 ❤️
+
+</div>

gsi_protocol_installer-1.0.2/gsi_installer.py

@@ -0,0 +1,289 @@
+"""
+GSI-Protocol Installer
+
+A simple CLI tool to install GSI-Protocol workflow commands for Claude Code and/or Codex.
+
+Usage:
+    uvx gsi-protocol-installer
+    # or
+    pipx run gsi-protocol-installer
+"""
+
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+import shutil
+import tempfile
+import subprocess
+
+
+class Colors:
+    """ANSI color codes for terminal output."""
+    HEADER = '\033[95m'
+    OKBLUE = '\033[94m'
+    OKCYAN = '\033[96m'
+    OKGREEN = '\033[92m'
+    WARNING = '\033[93m'
+    FAIL = '\033[91m'
+    ENDC = '\033[0m'
+    BOLD = '\033[1m'
+
+
+def print_header():
+    """Print installation header."""
+    print(f"\n{Colors.BOLD}🚀 GSI-Protocol Installer{Colors.ENDC}")
+    print("=" * 60)
+    print()
+
+
+def print_success(message: str):
+    """Print success message."""
+    print(f"{Colors.OKGREEN}✓{Colors.ENDC} {message}")
+
+
+def print_error(message: str):
+    """Print error message."""
+    print(f"{Colors.FAIL}✗{Colors.ENDC} {message}")
+
+
+def print_warning(message: str):
+    """Print warning message."""
+    print(f"{Colors.WARNING}⚠{Colors.ENDC} {message}")
+
+
+def print_info(message: str):
+    """Print info message."""
+    print(f"{Colors.OKCYAN}ℹ{Colors.ENDC} {message}")
+
+
+def prompt_choice(question: str, choices: list[str], default: int = 1) -> int:
+    """Prompt user for a choice."""
+    print(f"\n{Colors.BOLD}{question}{Colors.ENDC}")
+    for i, choice in enumerate(choices, 1):
+        print(f"{i}) {choice}")
+    
+    while True:
+        try:
+            response = input(f"Enter choice [1-{len(choices)}] (default: {default}): ").strip()
+            if not response:
+                return default
+            choice = int(response)
+            if 1 <= choice <= len(choices):
+                return choice
+            print_error(f"Please enter a number between 1 and {len(choices)}")
+        except ValueError:
+            print_error("Please enter a valid number")
+        except KeyboardInterrupt:
+            print("\n\nInstallation cancelled.")
+            sys.exit(0)
+
+
+def prompt_yes_no(question: str, default: bool = False) -> bool:
+    """Prompt user for yes/no."""
+    default_str = "Y/n" if default else "y/N"
+    while True:
+        try:
+            response = input(f"{question} [{default_str}]: ").strip().lower()
+            if not response:
+                return default
+            if response in ['y', 'yes']:
+                return True
+            if response in ['n', 'no']:
+                return False
+            print_error("Please enter 'y' or 'n'")
+        except KeyboardInterrupt:
+            print("\n\nInstallation cancelled.")
+            sys.exit(0)
+
+
+def download_commands(repo_url: str = "https://github.com/CodeMachine0121/GSI-Protocol.git") -> Path:
+    """Download command files from GitHub."""
+    print_info("Downloading GSI-Protocol from GitHub...")
+    
+    temp_dir = Path(tempfile.mkdtemp())
+    
+    try:
+        # Clone the repository
+        result = subprocess.run(
+            ["git", "clone", "--depth", "1", repo_url, str(temp_dir / "gsi-protocol")],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        print_success("Downloaded successfully")
+        return temp_dir / "gsi-protocol"
+    except subprocess.CalledProcessError as e:
+        print_error(f"Failed to download: {e.stderr}")
+        sys.exit(1)
+    except FileNotFoundError:
+        print_error("Git is not installed. Please install git first.")
+        sys.exit(1)
+
+
+def install_commands(source_dir: Path, platform: str, location: str) -> int:
+    """Install commands to the specified location."""
+    installed_count = 0
+    
+    if location == "global":
+        if platform in ["claude", "both"]:
+            target_dir = Path.home() / ".claude" / "commands"
+            target_dir.mkdir(parents=True, exist_ok=True)
+            
+            source = source_dir / ".claude" / "commands"
+            for file in source.glob("sdd-*.md"):
+                shutil.copy2(file, target_dir / file.name)
+                installed_count += 1
+            
+            print_success(f"Installed {installed_count} Claude Code commands to {target_dir}")
+        
+        if platform in ["codex", "both"]:
+            target_dir = Path.home() / ".codex" / "prompts"
+            target_dir.mkdir(parents=True, exist_ok=True)
+            
+            source = source_dir / ".codex" / "prompts"
+            for file in source.glob("sdd-*.md"):
+                shutil.copy2(file, target_dir / file.name)
+                installed_count += 1
+            
+            print_success(f"Installed {len(list((target_dir).glob('sdd-*.md')))} Codex prompts to {target_dir}")
+    
+    else:  # project
+        if platform in ["claude", "both"]:
+            target_dir = Path.cwd() / ".claude" / "commands"
+            
+            if target_dir.exists():
+                if not prompt_yes_no(f"⚠️  {target_dir} already exists. Overwrite?", default=False):
+                    print_warning("Skipping Claude Code installation")
+                else:
+                    target_dir.mkdir(parents=True, exist_ok=True)
+                    source = source_dir / ".claude" / "commands"
+                    for file in source.glob("sdd-*.md"):
+                        shutil.copy2(file, target_dir / file.name)
+                        installed_count += 1
+                    print_success(f"Installed {installed_count} Claude Code commands to {target_dir}")
+            else:
+                target_dir.mkdir(parents=True, exist_ok=True)
+                source = source_dir / ".claude" / "commands"
+                for file in source.glob("sdd-*.md"):
+                    shutil.copy2(file, target_dir / file.name)
+                    installed_count += 1
+                print_success(f"Installed {installed_count} Claude Code commands to {target_dir}")
+        
+        if platform in ["codex", "both"]:
+            target_dir = Path.cwd() / ".codex" / "prompts"
+            
+            if target_dir.exists():
+                if not prompt_yes_no(f"⚠️  {target_dir} already exists. Overwrite?", default=False):
+                    print_warning("Skipping Codex installation")
+                else:
+                    target_dir.mkdir(parents=True, exist_ok=True)
+                    source = source_dir / ".codex" / "prompts"
+                    for file in source.glob("sdd-*.md"):
+                        shutil.copy2(file, target_dir / file.name)
+                        installed_count += 1
+                    print_success(f"Installed {len(list((target_dir).glob('sdd-*.md')))} Codex prompts to {target_dir}")
+            else:
+                target_dir.mkdir(parents=True, exist_ok=True)
+                source = source_dir / ".codex" / "prompts"
+                for file in source.glob("sdd-*.md"):
+                    shutil.copy2(file, target_dir / file.name)
+                    installed_count += 1
+                print_success(f"Installed {len(list((target_dir).glob('sdd-*.md')))} Codex prompts to {target_dir}")
+    
+    return installed_count
+
+
+def detect_installation_type() -> str:
+    """Detect if we're in a git repository."""
+    try:
+        subprocess.run(
+            ["git", "rev-parse", "--git-dir"],
+            capture_output=True,
+            check=True
+        )
+        return "project"
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return "unknown"
+
+
+def main():
+    """Main installation flow."""
+    print_header()
+    
+    # Step 1: Choose platform
+    platform_choice = prompt_choice(
+        "Select AI platform(s) to install:",
+        [
+            "Claude Code only",
+            "Codex (OpenAI) only",
+            "Both Claude Code and Codex"
+        ],
+        default=3
+    )
+    
+    platform_map = {1: "claude", 2: "codex", 3: "both"}
+    platform = platform_map[platform_choice]
+    
+    # Step 2: Choose installation location
+    detected = detect_installation_type()
+    
+    if detected == "project":
+        print_success("Git repository detected")
+        location_choice = prompt_choice(
+            "Choose installation type:",
+            [
+                "Install to current project",
+                "Install globally to home directory"
+            ],
+            default=1
+        )
+    else:
+        print_info("Not in a git repository")
+        location_choice = prompt_choice(
+            "Choose installation type:",
+            [
+                "Install to current directory",
+                "Install globally to home directory"
+            ],
+            default=2
+        )
+    
+    location = "project" if location_choice == 1 else "global"
+    
+    # Step 3: Download
+    print()
+    source_dir = download_commands()
+    
+    # Step 4: Install
+    print()
+    installed_count = install_commands(source_dir, platform, location)
+    
+    # Step 5: Cleanup
+    shutil.rmtree(source_dir.parent)
+    
+    # Step 6: Success message
+    print()
+    print("=" * 60)
+    print_success(f"Installation complete! Total files installed: {installed_count}")
+    print()
+    print("You can now use SDD commands:")
+    print("  /sdd-auto <requirement>")
+    print("  /sdd-spec <requirement>")
+    print("  /sdd-arch <feature.feature>")
+    print("  /sdd-impl <feature.feature>")
+    print("  /sdd-verify <feature.feature>")
+    print()
+    print(f"📖 Documentation: {Colors.OKCYAN}https://github.com/CodeMachine0121/GSI-Protocol{Colors.ENDC}")
+    print()
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\nInstallation cancelled.")
+        sys.exit(0)
+    except Exception as e:
+        print_error(f"Unexpected error: {e}")
+        sys.exit(1)

gsi_protocol_installer-1.0.2/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "gsi-protocol-installer"
+version = "1.0.2"
+description = "Installer for GSI-Protocol workflow commands (Claude Code & Codex)"
+authors = [
+    {name = "James Hsueh", email = "asdfg55887@gmail.com"}
+]
+maintainers = [
+    {name = "GSI-Protocol Contributors"}
+]
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+keywords = ["gsi-protocol", "sdd", "bdd", "gherkin", "claude", "codex", "ai", "workflow", "spec-driven-development"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Quality Assurance",
+    "Environment :: Console",
+]
+
+[project.urls]
+Homepage = "https://github.com/CodeMachine0121/GSI-Protocol"
+Documentation = "https://github.com/CodeMachine0121/GSI-Protocol/blob/main/README.md"
+Repository = "https://github.com/CodeMachine0121/GSI-Protocol"
+Issues = "https://github.com/CodeMachine0121/GSI-Protocol/issues"
+Changelog = "https://github.com/CodeMachine0121/GSI-Protocol/blob/main/CODEX_SUPPORT_CHANGELOG.md"
+
+[project.scripts]
+gsi-install = "gsi_installer:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+only-include = ["gsi_installer.py"]
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+    "gsi_installer.py",
+    "pyproject.toml",
+    "README.md",
+    "LICENSE",
+    "MANIFEST.in"
+]