跳到主要内容

Skills 工作流程指南

GST 開發團隊使用自開發的 Slash Command Skills 自動化軟體開發生命週期。每個 Skill 由特定角色（PM / Dev / Reviewer）在對應的 terminal 執行。

Skill 總覽​

依角色分類​

角色Skill說明
PM/generate-task為 Linear Issue 產出開發指令
PM/review-fix讀取 Review Report，產出修正指令
PM/create-pr建立 Pull Request
PM/batch-pr批次建立多個 Sub-Issue 的 PR
PM/plan-feature規劃多 Issue Feature 的執行計畫
PM/merge-check檢查跨 Repo PR 依賴是否可合併
PM/log-issue分析 Error Log 並建立 Linear Issue
PM/status-overview跨團隊 Linear Issue 狀態總覽
PM/workspace-status所有 Repo 的 Git 狀態概覽
PM/onboard-project分析 .NET 專案，產出設定檔
Dev/pick-task取得 Linear Issue 並建立分支（支援 Resume 模式）
Dev/done產出完成回報並更新 Linear 狀態
Dev/pick-next自動取得 Feature 的下一個 Sub-Issue
Dev/gst-issue回報底層 Framework 問題到 GitHub
Reviewer/review-pr結構化審查 PR
Reviewer/re-reviewPR 修正後重新審查
Reviewer/approve-mergeApprove + Squash Merge PR
Reviewer/batch-review批次審查多個 PR

標準開發流程​

單一 Issue 流程​

┌──────────────────────────────────────────────────────────────────┐
│                      PM Terminal                                 │
│                                                                  │
│  Step 1: /generate-task JOP-167                                  │
│          研究程式碼 → 產出開發指令 → 寫入 Linear Comment         │
│                                                                  │
│  Step 5: /create-pr JOP-167                                      │
│          組裝 PR 內容 → 建立 PR                                  │
│                                                                  │
│  Step 7: (Review 通過) → Squash Merge → 確認 Linear Done        │
└──────────────────────────────────────────────────────────────────┘
          │                            ▲                    ▲
          ▼                            │                    │
┌──────────────────────────────────────────────────────────────────┐
│                     Dev Terminal                                  │
│                                                                  │
│  Step 2: /pick-task JOP-167                                      │
│          讀取 Linear → 建立分支 → 顯示開發指令                  │
│                                                                  │
│  Step 3: (開發、測試、Commit)                                    │
│                                                                  │
│  Step 4: /done JOP-167                                           │
│          產出完成回報 → 寫入 Linear → Push                       │
└──────────────────────────────────────────────────────────────────┘
          │                            ▲
          ▼                            │
┌──────────────────────────────────────────────────────────────────┐
│                    Reviewer Terminal                              │
│                                                                  │
│  Step 6: /review-pr {repo}#{PR-number}                           │
│          審查 → GitHub PR Review + Linear Comment                │
│          APPROVE → 回 PM 合併                                    │
│          REQUEST_CHANGES → 回 PM 執行 /review-fix               │
└──────────────────────────────────────────────────────────────────┘

Review Fix 迴圈​

Reviewer: REQUEST_CHANGES
    ↓
PM: /review-fix JOP-167 → 產出修正指令
    ↓
Dev: /pick-task JOP-167 → 自動偵測 Resume 模式 → 修正 → Push
    ↓
Reviewer: /re-review {repo}#{PR} → APPROVE 或再次 REQUEST_CHANGES

多 Issue Feature 流程​

適用於有 Parent Issue + 多個 Sub-Issue 的功能開發：

PM: /plan-feature GST-198 → 分析 Sub-Issues → 決定執行順序
    ↓
Dev: /pick-next GST-198 → 自動找到下一個可執行的 Sub-Issue
    ↓
Dev: 開發 → /done → /pick-next GST-198（循環）
    ↓ (全部完成)
PM: /batch-pr GST-198 → 批次建立所有 Sub-Issue 的 PR
    ↓
Reviewer: /batch-review {repo}#{start}-{end} → 批次審查
    ↓
PM/Reviewer: 依 Phase 順序 Merge

Skill 互動關係​

                    ┌──────────────────┐
                    │ /status-overview  │
                    │ /workspace-status │
                    └────────┬─────────┘
                             │ 評估狀態
                             ▼
               ┌──────────────────────────┐
               │     /plan-feature        │  多 Issue Feature
               │  或 /generate-task       │  單一 Issue
               │  或 /log-issue           │  Error 驅動
               └──────────┬───────────────┘
                          │ 開發指令寫入 Linear
                          ▼
               ┌──────────────────────────┐
               │  /pick-task              │  單一 Issue
               │  或 /pick-next           │  多 Issue Feature
               └──────────┬───────────────┘
                          │ 建立分支、開發
                          ▼
               ┌──────────────────────────┐
               │       /done              │
               └──────────┬───────────────┘
                          │ 完成回報
                          ▼
               ┌──────────────────────────┐
               │  /create-pr 或 /batch-pr │
               └──────────┬───────────────┘
                          │ PR 建立
                          ▼
               ┌──────────────────────────┐
               │ /review-pr 或 /batch-review │
               └──────────┬───────────────┘
                          │
                ┌─────────┴──────────┐
                ▼                    ▼
           APPROVE              REQUEST_CHANGES
                │                    │
                ▼                    ▼
        /approve-merge          /review-fix
                                     │
                                     ▼
                              /pick-task (Resume)
                                     │
                                     └──→ /re-review

Linear Comment 標記約定​

Skills 透過特定的 Comment 標題互相串接：

標題產出者消費者說明
## 開發指令/generate-task, /plan-feature, /log-issue/pick-task, /pick-next開發任務指令
## 完成回報/done (Normal)/create-pr, /review-fix開發完成報告
## 修正回報/done (Review Fix)/re-reviewReview 修正完成報告
## 審查結果/review-pr/review-fixPR Review 摘要
## 審查修正指令/review-fix/pick-task (Resume)PR Review 修正指令
## 執行計畫/plan-feature/pick-next, /batch-prFeature 執行順序
注意

修改這些標題時必須同步更新所有相關 Skill。

Hooks 自動防護​

Hook攔截內容範例
Commit 格式非 conventional commitadded stuff → 阻擋
禁止字樣程式碼/commit 含禁止詞歸屬標記 → 阻擋
危險操作force push、push 共用分支git push --force → 阻擋
跨 Repo 編輯修改自身 repo 外的檔案App 改 Core/ 下檔案 → 阻擋

相關文件​