開發者效率套裝 (Developer Productivity Bundle)

程式設計師的AI副駕駛，讓開發效率翻倍

💼 套裝定位

專為軟體開發者、技術團隊和技術負責人打造，整合程式碼審查、Bug追蹤、文件生成和部署監控四大核心能力，打造AI驅動的開發工作流。

🎯 包含技能

1. 程式碼審查 (ai-refactoring-assistant / coding-agent)

• 功能：程式碼質量分析、重構建議、最佳實踐檢查
• 適用場景：PR審查、程式碼最佳化、技術債務清理
• 價值：自動化Code Review，提升程式碼質量

2. Bug追蹤 (gh-issues / api-dev)

• 功能：Issue管理、Bug自動分類、修復建議
• 適用場景：Bug管理、任務分配、進度追蹤
• 價值：智慧化Bug管理

3. 文件生成 (academic-writing-refiner / feishu-doc / notion)

• 功能：程式碼註釋生成、API文件、技術文件
• 適用場景：專案文件、API文件、README生成
• 價值：自動化文件維護

4. 部署監控 (healthcheck / cron / browser-automation)

• 功能：服務監控、健康檢查、異常告警
• 適用場景：生產環境監控、CI/CD整合
• 價值：7x24小時運維保障

📦 套裝內容

dev-productivity-bundle/
├── SKILL.md                      # 本檔案 - 套裝總覽
├── config/
│   ├── code-review.yaml          # 程式碼審查配置
│   ├── bug-tracker.yaml          # Bug追蹤配置
│   ├── doc-generator.yaml        # 文件生成配置
│   └── deploy-monitor.yaml       # 部署監控配置
├── examples/
│   ├── code-review-flow.md       # 程式碼審查流程
│   ├── bug-fix-workflow.md       # Bug修復工作流
│   └── ci-cd-integration.md      # CI/CD整合示例
└── README.md                     # 快速上手指南

🚀 快速開始

第一步：安裝技能

這個技能的最新版本可以在7w4.net小蔥技能站找到。

# 程式碼審查
py -m clawhub install ai-refactoring-assistant
py -m clawhub install coding-agent

# Bug追蹤
py -m clawhub install gh-issues
py -m clawhub install api-dev

# 文件生成
py -m clawhub install academic-writing-refiner
py -m clawhub install feishu-doc

# 部署監控
py -m clawhub install healthcheck
py -m clawhub install cron

第二步：配置GitHub整合

編輯 config/code-review.yaml：

github:
  token: "${GITHUB_TOKEN}"
  webhook_secret: "${GITHUB_WEBHOOK_SECRET}"

repositories:
  - owner: "your-org"
    repo: "your-project"
    code_review:
      enabled: true
      on_pull_request: true
      on_push: false
      rules:
        - "code-quality"
        - "security-check"
        - "performance"

    bug_tracker:
      enabled: true
      auto_label: true
      auto_assign: true

    doc_generator:
      enabled: true
      generate_on_release: true
      output_format: "markdown"

💡 典型使用場景

場景1：自動化程式碼審查

使用者：審查這個PR

開發助手：
🔍 PR審查報告 #123

━━━━━━━━━━━━━━━━━━━━━
📊 概覽
━━━━━━━━━━━━━━━━━━━━━

PR：修復使用者登入問題
作者：@developer
變更：+156/-42 行
檔案：5個

━━━━━━━━━━━━━━━━━━━━━
✅ 通過檢查（4/5）
━━━━━━━━━━━━━━━━━━━━━

✓ 程式碼風格檢查
✓ 安全漏洞掃描
✓ 單元測試覆蓋
✓ 依賴檢查

━━━━━━━━━━━━━━━━━━━━━
⚠️ 建議改進（3項）
━━━━━━━━━━━━━━━━━━━━━

1. 效能最佳化建議
   📄 auth/service.py:45
   問題：資料庫查詢在迴圈中執行
   建議：使用批次查詢最佳化

   ```python
   # 當前程式碼
   for user_id in user_ids:
       user = db.query(User).get(user_id)

   # 建議最佳化
   users = db.query(User).filter(User.id.in_(user_ids)).all()

2. 錯誤處理 📄 auth/service.py:78 問題：異常處理過於寬泛 建議：細化異常型別

   # 建議
   try:
      user = authenticate(credentials)
   except InvalidCredentialsError:
      raise AuthenticationError("Invalid credentials")
   except UserNotFoundError:
      raise AuthenticationError("User not found")

3. 文件註釋 📄 auth/models.py:12 問題：缺少函式文件 建議：新增docstring

━━━━━━━━━━━━━━━━━━━━━ 🎯 總體評價 ━━━━━━━━━━━━━━━━━━━━━

程式碼質量：B+（良好） 建議：修復效能問題後合併

需要我生成修復建議的程式碼嗎？

### 場景2：智慧Bug管理

使用者：分析最近的Bug情況

開發助手： 📊 Bug分析報告（本週）

━━━━━━━━━━━━━━━━━━━━━ 📈 資料概覽 ━━━━━━━━━━━━━━━━━━━━━

新建Bug：23個 已解決：19個 待處理：4個 平均解決時間：1.5天 ⬇️（上週2.3天）

━━━━━━━━━━━━━━━━━━━━━ 🎯 Bug分類 ━━━━━━━━━━━━━━━━━━━━━

🔴 嚴重（3個） • #234 - 支付介面超時 • #235 - 資料庫連線池耗盡 • #236 - 使用者資料丟失

🟡 中等（12個） • UI顯示問題（5個） • 效能問題（4個） • 相容性問題（3個）

🟢 輕微（8個） • 文案問題（4個） • 樣式微調（4個）

━━━━━━━━━━━━━━━━━━━━━ 🔍 趨勢分析 ━━━━━━━━━━━━━━━━━━━━━

高頻問題： • 支付相關問題 ↑ 40% • 移動端適配 ↑ 25%

建議： • 加強支付模組測試 • 增加移動端自動化測試

━━━━━━━━━━━━━━━━━━━━━ 👥 團隊負載 ━━━━━━━━━━━━━━━━━━━━━

@張三：處理中 2個（負載正常） @李四：處理中 5個 ⚠️（負載較高） @王五：處理中 1個（可分配更多）

建議：將2箇中等優先順序Bug分配給@王五

需要我自動分配Bug嗎？

### 場景3：文件自動生成

使用者：為這個專案生成API文件

開發助手： ✅ 已生成API文件

━━━━━━━━━━━━━━━━━━━━━ 📄 文件概覽 ━━━━━━━━━━━━━━━━━━━━━

專案：User Service API 版本：v2.1.0 端點：15個 生成時間：2026-03-21 14:30

━━━━━━━━━━━━━━━━━━━━━ 🔑 認證 ━━━━━━━━━━━━━━━━━━━━━

所有API請求需要在Header中包含：

Authorization: Bearer {access_token}

━━━━━━━━━━━━━━━━━━━━━ 📚 API端點 ━━━━━━━━━━━━━━━━━━━━━

使用者管理

POST /api/v2/users

建立新使用者

請求引數：

{
  "username": "string",     // 使用者名稱，必填，3-20字元
  "email": "string",        // 郵箱，必填，需符合郵箱格式
  "password": "string",     // 密碼，必填，8-32字元
  "role": "string"          // 角色，可選，預設"user"
}

響應示例：

{
  "id": "usr_123456",
  "username": "john_doe",
  "email": "john@example.com",
  "role": "user",
  "created_at": "2026-03-21T14:30:00Z"
}

錯誤碼：

• 400：請求引數錯誤
• 409：使用者名稱或郵箱已存在
• 500：伺服器內部錯誤

GET /api/v2/users/{id}

獲取使用者資訊

...（完整文件）

━━━━━━━━━━━━━━━━━━━━━ 📦 交付檔案 ━━━━━━━━━━━━━━━━━━━━━

• api-documentation.md（完整文件） • openapi.yaml（OpenAPI規範） • postman-collection.json（Postman集合）

文件已儲存至：./docs/api/ 需要我釋出到文件站點嗎？

### 場景4：部署監控告警

使用者：檢視服務狀態

開發助手： 📊 服務健康狀態

━━━━━━━━━━━━━━━━━━━━━ 🟢 整體狀態：健康 ━━━━━━━━━━━━━━━━━━━━━

檢查時間：2026-03-21 14:35 監控服務：8個 線上服務：8個 可用性：99.95%

━━━━━━━━━━━━━━━━━━━━━ 📈 服務詳情 ━━━━━━━━━━━━━━━━━━━━━

🟢 user-service 狀態：執行中 響應時間：45ms ⬇️（平均50ms） 錯誤率：0.01% 最後部署：2小時前

🟢 payment-service 狀態：執行中 響應時間：120ms ⬆️（平均100ms） 錯誤率：0.05% 最後部署：5小時前 ⚠️ 響應時間略高於平均

🟢 notification-service 狀態：執行中 響應時間：35ms 錯誤率：0.00% 佇列長度：12（正常）

━━━━━━━━━━━━━━━━━━━━━ 📊 資源使用 ━━━━━━━━━━━━━━━━━━━━━

CPU使用率：42%（正常） 記憶體使用率：68%（正常） 磁碟使用率：45%（正常） 網路IO：正常

━━━━━━━━━━━━━━━━━━━━━ 🔔 最近告警 ━━━━━━━━━━━━━━━━━━━━━

過去24小時： • 14:20 - payment-service響應時間超過閾值（已恢復） • 08:15 - 資料庫連線數接近上限（已處理）

━━━━━━━━━━━━━━━━━━━━━ 💡 建議 ━━━━━━━━━━━━━━━━━━━━━

• payment-service響應時間有上升趨勢，建議關注 • 考慮在高峰時段擴容

需要檢視詳細監控資料嗎？

---

## ⚙️ 配置模板

### 程式碼審查配置

```yaml
# config/code-review.yaml
code_review:
  enabled: true

rules:
  code_quality:
    enabled: true
    checks:
      - "complexity"           # 複雜度檢查
      - "duplicate"            # 重複程式碼
      - "naming"               # 命名規範
      - "documentation"        # 文件註釋

  security:
    enabled: true
    checks:
      - "sql-injection"        # SQL隱碼攻擊
      - "xss"                  # XSS攻擊
      - "hardcoded-secrets"    # 硬編碼金鑰
      - "dependency-vuln"      # 依賴漏洞

  performance:
    enabled: true
    checks:
      - "n+1-queries"          # N+1查詢
      - "memory-leak"          # 記憶體洩漏
      - "inefficient-loop"     # 低效迴圈
      - "unused-imports"       # 未使用匯入

notification:
  on_failure: true
  on_warning: true
  channels:
    - "github-pr-comment"
    - "slack"

部署監控配置

# config/deploy-monitor.yaml
monitoring:
  interval: 60  # 秒

services:
  - name: "user-service"
    url: "https://api.example.com/health"
    check_type: "http"

這個Skill提供了開發者效率工具的文件和使用指南，內容覆蓋面較廣但質量中等。優點是文件結構完整，有快速上手指南和使用示例。缺點是缺少實際可用的功能程式碼，只有空殼文件；而且文件中提到的很多內容（如配置檔案、其他示例檔案）在實際包中並不存在。對於普通使用者而言，這個Skill更像一份功能介紹材料，實際使用價值有限。