Communitygithub.com

Lev-it/lev-skills

透過狀態機管理議題分類角色——分類、重現、必要時追問,並撰寫可供AI代理直接使用的簡報。

lev-skills 是什麼?

這項技能將議題追蹤器上的問題導向一個小型狀態機,由分類角色(錯誤、增強)與狀態角色(需分類、需資訊、可交代理、需人手、不予處理)組成。它能自動化議題分類流程:蒐集上下文、推薦分類與狀態、嘗試重現錯誤、透過追問與領域建模來釐清規格不足的議題,最後根據結果張貼代理簡報或分類筆記。支援多種平台(如GitHub Issues),並可與「/grilling」及「/domain-modeling」技能協同運作。適用於那些希望在維持人工審查控制的同時,將重複性分類工作委託給AI代理的開發團隊。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/triage

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

分類

將專案議題追蹤器上的問題,透過一個小型的狀態機進行分類角色管理。

分類期間張貼到議題追蹤器的每一則留言或議題必須以以下免責聲明開頭:

> *此內容由AI在分類過程中產生。*

參考文件

角色

兩種分類角色:

  • bug — 某個東西壞了
  • enhancement — 新功能或改善

五種狀態角色:

  • needs-triage — 維護者需要評估
  • needs-info — 等待回報者提供更多資訊
  • ready-for-agent — 已完整定義,可交給離線AI代理
  • ready-for-human — 需要由人工實作
  • wontfix — 不會處理

每個經過分類的議題應精確攜帶一個分類角色與一個狀態角色。若狀態角色衝突,請標記出來並在進行任何其他操作前先詢問維護者。

這些是標準角色名稱——議題追蹤器上實際使用的標籤字串可能不同。對應關係應已提供給你——若尚未提供,請執行 /setup-matt-pocock-skills。

狀態轉換:未標籤的議題通常先進入 needs-triage;從那裡可移往 needs-info、ready-for-agent、ready-for-human 或 wontfix。needs-info 在回報者回覆後會回到 needs-triage。維護者隨時可以覆寫——請標記看起來不尋常的轉換,並在繼續前先詢問。

調用方式

維護者輸入 /triage 並以自然語言描述他們想要什麼。解讀請求後採取行動。範例:

  • "顯示任何需要我關注的事項"
  • "我們來看看 #42"
  • "將 #42 移至 ready-for-agent"
  • "有哪些議題是代理可以承攬的?"

顯示需要關注的項目

查詢議題追蹤器並呈現三個區塊,以最早建立者優先排序:

  1. 未標籤 — 從未經過分類。
  2. needs-triage — 正在評估中。
  3. needs-info 且回報者在上次分類註記後有新活動 — 需要重新評估。

顯示每個區塊的數量以及每項議題的一行摘要。讓維護者挑選。

分類特定議題

  1. 蒐集上下文。 閱讀完整的議題(內文、留言、標籤、回報者、日期)。解析任何先前的分類註記,以免重複詢問已解決的問題。使用專案的領域詞彙表探索程式碼,並尊重該區域的 ADR。閱讀 .out-of-scope/*.md 並找出任何與此議題相似的先前拒絕記錄。

  2. 推薦。 向維護者說明你的分類與狀態建議及理由,並附上與該議題相關的簡要程式碼摘要。等待指示。

  3. 重現(僅限錯誤)。 在追問之前,先嘗試重現:閱讀回報者的步驟、追蹤相關程式碼、執行測試或命令。回報結果——成功重現並附上程式碼路徑、重現失敗、或資訊不足(強烈的 needs-info 訊號)。確認的重現案例能使代理簡報有力得多。

  4. 追問(如有需要)。 若議題需要進一步釐清,請同時執行 /grilling 和 /domain-modeling 技能——一次一個問題地將議題追問成形,釐清領域詞彙,並在決策確定時即時更新 CONTEXT.md/ADR。

  5. 套用結果:

    • ready-for-agent — 張貼代理簡報留言(AGENT-BRIEF.md)。
    • ready-for-human — 結構與代理簡報相同,但說明為何無法委派(判斷問題、外部權限、設計決策、手動測試)。
    • needs-info — 張貼分類註記(範本如下)。
    • wontfix(錯誤) — 禮貌解釋後關閉。
    • wontfix(增強) — 寫入 .out-of-scope/,從留言中連結到該檔案,然後關閉(OUT-OF-SCOPE.md)。
    • needs-triage — 套用角色。可選擇性地留言,若有部分進度。

快速狀態覆寫

若維護者說「將 #42 移至 ready-for-agent」,請相信他們並直接套用角色。確認你即將執行的操作(角色變更、留言、關閉),然後行動。跳過追問階段。若移動到 ready-for-agent 但未經追問,請詢問他們是否要撰寫代理簡報。

需要資訊範本

## 分類註記

**目前已確立的內容:**

- 要點 1
- 要點 2

**我們仍需要你(@reporter)提供的事項:**

- 問題 1
- 問題 2

將追問過程中解決的所有事項記錄在「目前已確立的內容」下方,以免工作遺失。問題必須具體且可操作,而非「請提供更多資訊」。

恢復先前的工作階段

若議題上已有先前的分類註記,請閱讀它們,檢查回報者是否已回答任何待解決問題,並在繼續之前呈現更新後的狀況。不要重複詢問已解決的問題。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

相關技能