redshift-comment-mcp 0.1.0a0__tar.gz

redshift_comment_mcp-0.1.0a0/.github/BRANCH_PROTECTION_GUIDE.md

@@ -0,0 +1,72 @@
+# Main 分支保護設定指南
+
+## 設定位置
+前往 Repository → Settings → Branches → Add rule
+
+## 建議的保護規則
+
+### Branch name pattern
+```
+main
+```
+
+### 保護設定
+
+#### ✅ 必須啟用的保護項目：
+- **Require a pull request before merging**
+  - Required number of approvals before merging: `1`
+  - Dismiss stale PR approvals when new commits are pushed
+  - Require review from code owners (如果有 CODEOWNERS)
+
+- **Require status checks to pass before merging**  
+  - Require branches to be up to date before merging
+  - Status checks required:
+    - `test` (來自 test.yml workflow)
+
+- **Restrict pushes that create files larger than 100MB**
+
+- **Do not allow force pushes**
+
+- **Do not allow deletions** 
+
+#### ⚠️ 重要設定：
+- **Include administrators** ✅ 
+  - 這確保即使是 repository 擁有者也必須遵循保護規則
+  - 避免意外的直接推送到 main
+
+## 工作流程影響
+
+### 正常開發流程：
+1. 從 main 建立 feature 分支
+2. 開發完成後建立 Pull Request
+3. 等待 CI 測試通過
+4. 自行 approve 並合併 PR
+5. 刪除 feature 分支
+
+### GitHub Actions 相容性：
+- ✅ CI/CD workflows 可以正常運作
+- ✅ 自動發布流程不受影響
+- ✅ 測試必須通過才能合併
+
+## 例外情況
+
+如果緊急需要直接推送到 main：
+1. 暫時停用保護規則
+2. 進行緊急修復  
+3. 立即重新啟用保護規則
+
+## 額外建議
+
+### 建立 CODEOWNERS 檔案 (可選)
+在 repository 根目錄建立 `.github/CODEOWNERS`：
+
+```
+# 全域代碼擁有者
+* @kouko
+
+# 特定檔案的擁有者
+.github/workflows/* @kouko
+pyproject.toml @kouko
+```
+
+這樣可以確保重要檔案的變更需要你的 review。

redshift_comment_mcp-0.1.0a0/.github/CODEOWNERS

@@ -0,0 +1,16 @@
+# 代碼擁有者設定
+# 確保重要檔案的變更需要特定人員的審查
+
+# 全域設定 - 所有檔案都需要 kouko 的審查
+* @kouko
+
+# GitHub Actions workflows - 需要額外謹慎
+.github/workflows/* @kouko
+
+# 專案核心配置檔案
+pyproject.toml @kouko
+LICENSE @kouko
+
+# 重要文檔
+README.md @kouko
+.github/DEPLOYMENT.md @kouko

redshift_comment_mcp-0.1.0a0/.github/DEPLOYMENT.md

@@ -0,0 +1,238 @@
+# GitHub Actions 自動化部署指南
+
+本專案使用 GitHub Actions 來自動化測試和發布流程。
+
+## 設定步驟
+
+### 1. 設定 API Tokens
+
+#### PyPI API Token
+1. 前往 [PyPI Account Settings](https://pypi.org/manage/account/)
+2. 點選 "Add API token"
+3. 設定 Token 名稱（例如：`redshift-comment-mcp-github`）
+4. 選擇 Scope：選擇特定專案或 "Entire account"
+5. 複製生成的 Token（格式：`pypi-...`）
+
+#### TestPyPI API Token
+1. 前往 [TestPyPI Account Settings](https://test.pypi.org/manage/account/)
+2. 點選 "Add API token"
+3. 設定 Token 名稱（例如：`redshift-comment-mcp-test`）
+4. 選擇 Scope："Entire account"（TestPyPI 通常選這個）
+5. 複製生成的 Token（格式：`pypi-...`）
+
+### 2. 在 GitHub 中設定 Secrets
+
+1. 前往你的 GitHub Repository
+2. 點選 **Settings** → **Secrets and variables** → **Actions**
+3. 分別添加兩個 Secrets：
+
+**PyPI Token:**
+- Name: `PYPI_API_TOKEN`
+- Value: 貼上 PyPI API Token
+
+**TestPyPI Token:**
+- Name: `TEST_PYPI_API_TOKEN`
+- Value: 貼上 TestPyPI API Token
+
+## 工作流程說明
+
+### 自動測試 (.github/workflows/test.yml)
+
+**觸發條件：**
+- Push 到 `main` 或 `develop` 分支
+- Pull Request 到 `main` 或 `develop` 分支
+
+**執行內容：**
+- 在 Python 3.10、3.11、3.12 環境下執行測試
+- 安裝依賴並運行 `pytest tests/`
+
+### TestPyPI 測試發布 (.github/workflows/test-publish.yml)
+
+**觸發條件：**
+- GitHub Pre-release 發布時自動觸發
+- 可手動觸發 (workflow_dispatch)
+
+**執行流程：**
+1. 執行完整測試確保品質
+2. 建置套件 (`python -m build`)
+3. 發布到 **TestPyPI**
+4. 驗證發布成功
+5. 測試安裝功能
+6. 自動在 Release 中添加測試報告留言
+
+### PyPI 正式發布 (.github/workflows/publish.yml)
+
+**觸發條件：**
+- GitHub Release 正式發布時自動觸發
+- 可手動觸發 (workflow_dispatch)
+
+**執行流程：**
+1. 執行完整測試確保品質
+2. 建置套件 (`python -m build`)
+3. 發布到 **PyPI**
+4. 驗證發布成功
+5. 自動在 Release 中添加發布報告留言
+
+## 發布新版本流程
+
+### 方法 1: 通過 GitHub Release（推薦）
+
+#### 步驟 1: 測試發佈（TestPyPI）
+
+1. **提交代碼變更**
+   ```bash
+   git add .
+   git commit -m "feat: add new feature" # 或 "fix: resolve bug" 或 "BREAKING CHANGE: ..."
+   git push origin main
+   ```
+
+2. **建立 Git Tag**
+   ```bash
+   # 建立版本標籤（例如：v0.2.0）
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+
+3. **建立 Pre-release**
+   - 前往 GitHub Repository → **Releases** → **Create a new release**
+   - Tag version: 選擇剛才建立的 tag（例如：`v0.2.0`）
+   - Release title: `Version 0.2.0 Release Candidate`
+   - 描述更新內容
+   - ✅ **勾選 "Set as a pre-release"**
+   - 點選 **Publish release**
+
+4. **自動測試發布**
+   - GitHub Actions 會自動觸發
+   - 執行測試 → 建置 → 發布到 **TestPyPI** → 驗證發布 → 測試安裝
+   - 可在 https://test.pypi.org/project/redshift-comment-mcp/ 查看
+
+#### 📊 如何確認 TestPyPI 發布成功
+
+**方法 1: Release 留言（最直觀）**
+1. 前往你的 Pre-release 頁面
+2. 查看自動生成的留言，包含：
+   - ✅ 發布狀態
+   - 🔗 TestPyPI 連結
+   - 📥 測試安裝指令
+
+**方法 2: GitHub Actions Summary**
+1. 前往 **Actions** 頁面
+2. 點選最新的 "Test Publish to TestPyPI" workflow run
+3. 查看 **Summary** 區域的 "TestPyPI 發布報告"
+4. 確認狀態顯示 ✅ 成功
+
+**方法 3: Actions 日誌詳細檢查**
+1. 在 workflow run 中點選 **test-publish** job
+2. 檢查各個步驟的狀態：
+   - ✅ "Publish to TestPyPI" - 上傳成功
+   - ✅ "Verify TestPyPI publication" - 確認可下載
+   - ✅ "Test installation from TestPyPI" - 安裝測試通過
+   - ✅ "Create Test Report" - 生成報告
+
+**方法 4: 手動確認**
+```bash
+# 直接查看 TestPyPI 網頁
+https://test.pypi.org/project/redshift-comment-mcp/
+
+# 或使用 API 檢查
+curl -s "https://test.pypi.org/pypi/redshift-comment-mcp/json" | jq '.releases | keys'
+```
+
+5. **驗證 TestPyPI 套件**
+   ```bash
+   # 從 TestPyPI 安裝測試
+   pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ redshift-comment-mcp==0.1.1
+   
+   # 測試功能是否正常
+   redshift-comment-mcp --help
+   ```
+
+#### 步驟 2: 正式發佈（PyPI）
+
+6. **建立正式 Release**
+   - 前往之前建立的 Pre-release
+   - 點選 **Edit release**
+   - ❌ **取消勾選 "Set as a pre-release"**
+   - Tag version 保持不變: `v0.2.0`（不需要修改）
+   - 點選 **Update release**
+
+7. **自動正式發布**
+   - GitHub Actions 會自動觸發
+   - 執行測試 → 建置 → 發布到 **PyPI**
+   - 可在 https://pypi.org/project/redshift-comment-mcp/ 查看
+
+### 方法 2: 手動觸發
+
+1. 前往 **Actions** → **Publish to PyPI**
+2. 點選 **Run workflow**
+3. 選擇分支並執行
+
+## 監控發布狀態
+
+1. 前往 **Actions** 頁面查看工作流程狀態
+2. 點選具體的 workflow run 查看詳細日誌
+3. 發布成功後，可在 [PyPI](https://pypi.org/project/redshift-comment-mcp/) 確認新版本
+
+## 故障排除
+
+### 常見問題
+
+1. **PyPI API Token 錯誤**
+   - 確認 Secret 名稱是 `PYPI_API_TOKEN`
+   - 確認 Token 有效且有權限
+
+2. **測試失敗**
+   - 檢查測試程式碼是否有問題
+   - 確保所有依賴都正確安裝
+
+3. **建置失敗**
+   - 檢查 `pyproject.toml` 設定是否正確
+   - 確認檔案結構完整
+
+### 查看日誌
+
+點選失敗的 Action 查看詳細錯誤訊息，通常會指出具體問題所在。
+
+## 版本號自動管理
+
+本專案使用 **setuptools-scm** 進行自動版本管理，版本號基於 Git 標籤自動生成。
+
+### 版本號規則
+
+- **正式版本**：基於 Git tag（例如：`v0.2.0` → 版本 `0.2.0`）
+- **開發版本**：自動生成（例如：`0.2.1.dev3+g1234567`）
+- **格式**：遵循 [語意化版本](https://semver.org/lang/zh-TW/) `MAJOR.MINOR.PATCH`
+
+### 版本類型建議
+
+```bash
+# Bug 修復（PATCH：0.1.0 → 0.1.1）
+git tag v0.1.1
+
+# 新功能（MINOR：0.1.1 → 0.2.0）
+git tag v0.2.0
+
+# 重大變更（MAJOR：0.2.0 → 1.0.0）
+git tag v1.0.0
+
+# 預發布版本
+git tag v0.2.0-rc1
+git tag v0.2.0-beta1
+```
+
+### 檢查當前版本
+
+```bash
+# 安裝 setuptools-scm
+pip install setuptools-scm
+
+# 查看當前版本
+python -c "from setuptools_scm import get_version; print(get_version())"
+```
+
+### 優點
+
+- ✅ **自動化**：無需手動更新 `pyproject.toml` 中的版本號
+- ✅ **同步**：版本號與 Git 歷史完全同步
+- ✅ **開發版本**：自動生成開發版本號，便於測試
+- ✅ **防錯**：避免忘記更新版本號的問題

redshift_comment_mcp-0.1.0a0/.github/workflows/publish.yml

@@ -0,0 +1,154 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # 允許手動觸發
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+    
+    - name: Run tests
+      run: |
+        pytest tests/ -v
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+    
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Get package version
+      id: get_version
+      run: |
+        pip install setuptools-scm
+        VERSION=$(python -c "from setuptools_scm import get_version; print(get_version())")
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "📋 Package version: $VERSION"
+
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        echo "🚀 Publishing to PyPI..."
+        twine upload dist/* --verbose
+        echo "✅ Published to PyPI successfully!"
+    
+    - name: Verify PyPI publication
+      run: |
+        echo "🔍 Verifying publication on PyPI..."
+        PACKAGE_NAME="redshift-comment-mcp"
+        VERSION="${{ steps.get_version.outputs.version }}"
+        
+        # 等待 PyPI 更新
+        sleep 30
+        
+        # 檢查套件是否存在於 PyPI
+        for i in {1..5};
+        do
+          echo "⏳ Attempt $i/5: Checking PyPI availability..."
+          if curl -f -s "https://pypi.org/pypi/$PACKAGE_NAME/$VERSION/json" > /dev/null;
+          then
+            echo "✅ Package $PACKAGE_NAME version $VERSION is available on PyPI!"
+            echo "🔗 PyPI URL: https://pypi.org/project/$PACKAGE_NAME/$VERSION/"
+            break
+          else
+            echo "⏳ Not yet available, waiting 30 seconds..."
+            sleep 30
+          fi
+          
+          if [ $i -eq 5 ];
+          then
+            echo "❌ Package not found on PyPI after 5 attempts"
+            exit 1
+          fi
+        done
+
+    - name: Create Release Report
+      if: always()
+      run: |
+        echo "## 🎉 PyPI Release Report" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "- **Package Name**: redshift-comment-mcp" >> $GITHUB_STEP_SUMMARY
+        echo "- **Version**: ${{ steps.get_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **PyPI URL**: https://pypi.org/project/redshift-comment-mcp/${{ steps.get_version.outputs.version }}/" >> $GITHUB_STEP_SUMMARY
+        echo "- **Status**: ${{ job.status == 'success' && '✅ Success' || '❌ Failed' }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 📥 Installation Command" >> $GITHUB_STEP_SUMMARY
+        echo '```bash' >> $GITHUB_STEP_SUMMARY
+        echo "pip install redshift-comment-mcp==${{ steps.get_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo '```' >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 🔄 Upgrade Command" >> $GITHUB_STEP_SUMMARY
+        echo '```bash' >> $GITHUB_STEP_SUMMARY
+        echo "pip install --upgrade redshift-comment-mcp" >> $GITHUB_STEP_SUMMARY
+        echo '```'
+
+    - name: Add comment to release
+      if: github.event_name == 'release' && success()
+      uses: actions/github-script@v6
+      with:
+        script: |
+          const version = '${{ steps.get_version.outputs.version }}';
+          const pypiUrl = `https://pypi.org/project/redshift-comment-mcp/${version}/`;
+          const installCmd = `pip install redshift-comment-mcp==${version}`;
+          const upgradeCmd = `pip install --upgrade redshift-comment-mcp`;
+          
+          const body = '## 🚀 PyPI 發布成功！\n\n' +
+            '**版本**: ' + version + '\n' +
+            '**PyPI 頁面**: ' + pypiUrl + '\n\n' +
+            '### 📥 安裝指令\n' +
+            '```bash\n' +
+            installCmd + '\n' +
+            '```\n\n' +
+            '### 🔄 升級指令\n' +
+            '```bash\n' +
+            upgradeCmd + '\n' +
+            '```\n\n' +
+            '### 📚 使用指南\n' +
+            '查看 [README.md](https://github.com/' + context.repo.owner + '/' + context.repo.repo + '#readme) 了解詳細的使用方式。\n\n' +
+            '---\n' +
+            '🤖 *此訊息由 GitHub Actions 自動生成*';
+
+          if (context.payload.release.discussion) {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.release.discussion.number,
+              body: body
+            });
+          } else {
+            console.log("No associated discussion found for this release. Skipping comment.");
+          }

redshift_comment_mcp-0.1.0a0/.github/workflows/test-publish.yml

@@ -0,0 +1,166 @@
+name: Test Publish to TestPyPI
+
+on:
+  release:
+    types: [prereleased]
+  workflow_dispatch:  # 允許手動觸發
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+    
+    - name: Run tests
+      run: |
+        pytest tests/ -v
+
+  test-publish:
+    needs: test
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+    
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine requests
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Get package version
+      id: get_version
+      run: |
+        pip install setuptools-scm
+        VERSION=$(python -c "from setuptools_scm import get_version; print(get_version())")
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "📋 Package version: $VERSION"
+    
+    - name: Publish to TestPyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        echo "📦 Publishing to TestPyPI..."
+        twine upload --repository testpypi dist/* --verbose
+        echo "✅ Published to TestPyPI successfully!"
+    
+    - name: Verify TestPyPI publication
+      run: |
+        echo "🔍 Verifying publication on TestPyPI..."
+        PACKAGE_NAME="redshift-comment-mcp"
+        VERSION="${{ steps.get_version.outputs.version }}"
+        
+        # 等待 TestPyPI 更新（通常需要幾分鐘）
+        sleep 30
+        
+        # 檢查套件是否存在於 TestPyPI
+        for i in {1..5};
+        do
+          echo "⏳ Attempt $i/5: Checking TestPyPI availability..."
+          if curl -f -s "https://test.pypi.org/pypi/$PACKAGE_NAME/$VERSION/json" > /dev/null;
+          then
+            echo "✅ Package $PACKAGE_NAME version $VERSION is available on TestPyPI!"
+            echo "🔗 TestPyPI URL: https://test.pypi.org/project/$PACKAGE_NAME/$VERSION/"
+            break
+          else
+            echo "⏳ Not yet available, waiting 30 seconds..."
+            sleep 30
+          fi
+          
+          if [ $i -eq 5 ];
+          then
+            echo "❌ Package not found on TestPyPI after 5 attempts"
+            exit 1
+          fi
+        done
+    
+    - name: Test installation from TestPyPI
+      run: |
+        echo "🧪 Testing installation from TestPyPI..."
+        PACKAGE_NAME="redshift-comment-mcp"
+        VERSION="${{ steps.get_version.outputs.version }}"
+        
+        # 建立新的虛擬環境進行測試
+        python -m venv test_env
+        source test_env/bin/activate
+        
+        # 從 TestPyPI 安裝
+        pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ "$PACKAGE_NAME==$VERSION"
+        
+        # 測試命令是否可用
+        redshift-comment-mcp --help
+        
+        echo "✅ Installation test passed!"
+    
+    - name: Create Test Report
+      if: always()
+      run: |
+        echo "## 📊 TestPyPI Publish Report" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "- **Package Name**: redshift-comment-mcp" >> $GITHUB_STEP_SUMMARY
+        echo "- **Version**: ${{ steps.get_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **TestPyPI URL**: https://test.pypi.org/project/redshift-comment-mcp/${{ steps.get_version.outputs.version }}/" >> $GITHUB_STEP_SUMMARY
+        echo "- **Status**: ${{ job.status == 'success' && '✅ Success' || '❌ Failed' }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 📥 Test Installation Command" >> $GITHUB_STEP_SUMMARY
+        echo '```bash' >> $GITHUB_STEP_SUMMARY
+        echo "pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ redshift-comment-mcp==${{ steps.get_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo '```' >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### ⚠️ Notes" >> $GITHUB_STEP_SUMMARY
+        echo "- After successful testing, please convert the Pre-release to a formal Release to trigger PyPI publishing." >> $GITHUB_STEP_SUMMARY
+        echo "- Packages on TestPyPI are for testing only. Please use the official PyPI for production installations." >> $GITHUB_STEP_SUMMARY
+    
+    - name: Add comment to release
+      if: github.event_name == 'release' && success()
+      uses: actions/github-script@v6
+      with:
+        script: |
+          const version = '${{ steps.get_version.outputs.version }}';
+          const testPypiUrl = `https://test.pypi.org/project/redshift-comment-mcp/${version}/`;
+          const installCmd = `pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ redshift-comment-mcp==${version}`;
+          
+          const body = '## 🎉 TestPyPI 發布成功！\n\n' +
+            '**版本**: ' + version + '\n' +
+            '**TestPyPI 頁面**: ' + testPypiUrl + '\n\n' +
+            '### 📥 測試安裝\n' +
+            '```bash\n' +
+            installCmd + '\n' +
+            '```\n\n' +
+            '### 🔄 下一步\n' +
+            '如果測試無誤，請將此 Pre-release 轉為正式 Release 以觸發 PyPI 發布。\n\n' +
+            '---' +
+            '🤖 *此訊息由 GitHub Actions 自動生成*';
+
+          if (context.payload.release.discussion) {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.release.discussion.number,
+              body: body
+            });
+          } else {
+            console.log("No associated discussion found for this release. Skipping comment.");
+          }

redshift_comment_mcp-0.1.0a0/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests
+      run: |
+        pytest tests/ -v --tb=short
+
+    - name: Run linting (if available)
+      run: |
+        # 如果有 linting 工具可以在這裡加入
+        echo "Linting skipped - add tools like ruff, black, etc. if needed"
+      continue-on-error: true