TTechSpecs

指令用途

/triage 是一個自動化的 issue 分類和處理系統。它會讀取 issues 和 PRs，依照預定義的狀態機流轉，自動進行分類、驗證，必要時進行追問，最終產生可供代理執行的簡報。

這就像有一個專門的 triage 團隊在幫你處理所有的 issues 和 PRs。

運作流程

  1. 讀取 items：讀取所有開放的 issues 和 PRs。
  2. 分類：根據內容自動分類（bug、feature、question、doc）。
  3. 驗證：檢查 issue 是否包含足夠的資訊（重現步驟、環境資訊）。
  4. 追問：如果資訊不足，自動發送追問。
  5. 標記：自動添加標籤（priority、status、category）。
  6. 產生簡報：產生可由代理執行的簡報。

實戰對話範例

範例一：處理新 issues

  • You: 
    /triage
  • AI:

    開始處理 triage 流程…

    找到 5 個開放的 issues

    Issue #42：登入閃退

    • 分類：bug
    • 優先級：high
    • 狀態：需要更多信息

    追問已發送：

    請提供以下資訊：

    • 操作系統和版本
    • 瀏覽器和版本
    • 重現步驟
    • 錯誤訊息或螢幕截圖

    Issue #43：新增暗黑模式

    • 分類：feature
    • 優先級：medium
    • 狀態：待處理

    Issue #44：如何使用 API？

    • 分類：question
    • 優先級：low
    • 狀態：已回答

    簡報已產生：docs/triage/2026-08-02-brief.md

範例二：處理外部 PRs

  • You: 
    /triage
  • AI:

    開始處理 triage 流程…

    找到 2 個開放的 PRs

    PR #12：修正登入 bug

    • 來源：external
    • 分類：bug
    • 狀態：需要審查

    審查檢查清單：

    • 是否通過所有測試？
    • 是否有足夠的測試覆蓋？
    • 是否符合程式碼風格？
    • 是否更新了文件？

    PR #13：新增單元測試

    • 來源：external
    • 分類：improvement
    • 狀態：待審查

    簡報已產生：docs/triage/2026-08-02-pr-brief.md

Triage 狀態機

[New Issue]
    |
    v
[Triage -> 分類]
    |
    +---> [Bug] -> [Verify Information] -> [Need Info] -> [Ask Questions] -> [Ready for Dev]
    |
    +---> [Feature] -> [Evaluate Priority] -> [Ready for Planning]
    |
    +---> [Question] -> [Answer] -> [Closed]
    |
    +---> [Doc] -> [Review] -> [Ready for Update]

[External PR]
    |
    v
[Triage -> 分類]
    |
    +---> [Bug Fix] -> [Review] -> [Merge or Request Changes]
    |
    +---> [Feature] -> [Review] -> [Merge or Request Changes]
    |
    +---> [Improvement] -> [Review] -> [Merge or Request Changes]

常見標籤

Status

  • needs-info：需要更多信息
  • ready-for-dev：準備開發
  • ready-for-planning：準備規劃
  • in-review：審查中
  • blocked：被阻塞
  • closed：已關閉

Priority

  • critical：緊急，影響生產環境
  • high：高優先級，影響重要功能
  • medium：中優先級，影響一般功能
  • low：低優先級，不影響功能

Category

  • bug：bug
  • feature：新功能
  • improvement：改進
  • question：問題
  • doc：文件

輸出檔案

檔案會自動建立到以下位置：

docs/
└── triage/
    ├── 2026-08-02-brief.md
    └── 2026-08-02-pr-brief.md

簡報格式：

# Triage Brief - 2026-08-02

## Issues

| ID | Title | Category | Priority | Status | Notes |
|----|-------|----------|----------|--------|-------|
| #42 | 登入閃退 | bug | high | needs-info | 等待回覆 |

## PRs

| ID | Title | Category | Status | Notes |
|----|-------|----------|--------|-------|
| #12 | 修正登入 bug | bug | in-review | 需要審查 |

## Action Items

1. 追蹤 Issue #42 的回覆
2. 審查 PR #12
3. 規劃 Issue #43

何時不應該使用

  • 已關閉的 issues：不需要處理
  • 草稿 PRs：等作者準備完成
  • spam issues：直接刪除或關閉