Community研究與資料分析github.com

steipete/github-project-triage

GitHub 問題/PR 分類:佇列、CI、阻礙、風險、證據、後續行動。

github-project-triage 是什麼?

此技能旨在協助 AI 代理對 GitHub 專案中的 Issue 和 Pull Request 進行高效且深入的分類與處理。它專為維護者設計,提供從佇列探索、項目評估、信任度判斷到自主執行修復的完整工作流程。技能支援多種平台,並自動偵測是否安裝了 `repobar` 二進位檔或 SwiftPM 產品。主要功能包括:使用 `repobar` 進行快速的跨倉庫佇列探索、對當前專案進行深度檢查(讀取所有評論、程式碼、CI 狀態)、根據 `VISION.md` 或內建規則判斷項目是否適合自主處理,以及執行安全的自動化工作流(實作、驗證、審查、合併)。它強制要求輸出中包含每個項目的 GitHub URL,並使用詳細的信任訊號(如貢獻者歷史)來調整審查深度,而不是將其視為正確性的絕對保證。分類輸出明確區分「可自主處理的候選」、「需要 Peter 決策的項目」和「應延遲/關閉/取代的項目」,並在自主模式下依序處理,直到所有安全項目完成或遇到需要人類介入的阻礙。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-project-triage

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

GitHub 專案分類

當使用者輸入 triage 時,一律使用此技能,除非請求明確針對非 GitHub 領域。從儲存庫內部使用時,預設使用當前的 GitHub 專案。分類指的是面向維護者的項目卡片:URL、每個 Issue/PR 的內容、其重要性、作者信任度、契合度、風險、證明/測試狀態、阻礙以及後續行動。絕不只回傳佇列編號或不透明參照。

輸出以 URL 為優先:每個被提出的 Issue/PR/儲存庫項目都必須在第一行或該項目的第一個句子中包含其 GitHub URL。如果需要提供簡短清單,則每個項目列印一個 URL。

僅將 RepoBar 用作第一遍,以在相關擁有者/組織之間進行廣泛的佇列探索。RepoBar 比手動撰寫 gh repo list 迴圈更快且更能感知設定檔,並且它已經了解儲存庫活動、Issue 數量、PR 數量、本地專案、認證、快取和過濾器。

設定

當已安裝時,優先使用真實的 repobar 二進位檔。在此工作區中,它可能僅作為 ~/Projects/RepoBar 中的 SwiftPM 產品存在。

repobar_cmd() {
  if command -v repobar >/dev/null 2>&1; then
    repobar "$@"
  elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
    "$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
  else
    swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
  fi
}

repobar_cmd status --json

廣泛分類的預設擁有者:steipete,openclaw。對於廣泛/預設佇列分類,即使 openclaw/openclaw 不是按數量排序的第一個儲存庫,也要包含對其的詳細檢查,因為它是主要的 ClawdBot/OpenClaw 佇列。除非使用者指名、當前儲存庫已屬於該擁有者,或任務明確要求所有/全部項目,否則不要包含 amantus-ai 或其他擁有者。對於特定擁有者的任務,不要擴大範圍超出指定的擁有者。

本地儲存庫關卡

在任何本地專案中開始工作之前,請確認檢出已準備就緒:

git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch

僅當分支是 main、拉取成功且工作目錄乾淨時才繼續。如果分支不是 main、拉取失敗或 git status --short 顯示有變更,請停止並詢問 Peter 該怎麼做。未經明確指示,請勿切換分支、暫存、提交、重設、還原或清理。

範圍規則

如果使用者說 triage 且當前工作目錄是具有 GitHub 遠端儲存庫的 Git 儲存庫,則僅對該專案進行分類。除非使用者說 broad、all、everything、提及多個擁有者/組織或要求跨儲存庫分類,否則不要擴大範圍到所有 Peter/組織的佇列。

如果儲存庫有 VISION.md,請在判斷哪些可以自主處理之前先閱讀它。將其用作產品契合度的真實來源,然後應用此技能的風險/可測試性規則。如果沒有 VISION.md,則使用下面的自主契合度規則。

尋找當前專案:

repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
  url=$(git remote get-url origin 2>/dev/null || true)
  repo=$(printf '%s\n' "$url" |
    sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\\.git$##')
fi
printf '%s\n' "$repo"

當前專案分類從以下開始:

gh issue list --repo "$repo" --state open --limit 50 \
  --json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
  --json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url

在對任何 Issue 或 PR 採取行動之前,請閱讀所有評論,並將 Peter/擁有者的評論視為權威的指導說明。如果 Peter 說它看起來不錯、需要修改、已被取代、已獲產品批准或不想要,則這會覆蓋機器人標籤和一般的分類判斷。如果沒有 Peter/擁有者的評論,則使用維護者的判斷,並說明這個決定是由你做出的。

然後檢查足夠的細節以解釋每個被提出的項目。對於小型佇列(大約 10 個或更少的開放項目),檢查所有項目。對於較大的佇列,檢查最高優先級的切片,並說明哪些未被展開。

gh issue view <n> --repo "$repo" \
  --json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
  --json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch

僅在有強力證據的情況下才進行評論、關閉、合併、重新執行或修補。

分類輸出

當使用者說 triage 時,務必掃描當前儲存庫的開放 Issue 和開放 PR。回傳:

  • 可自主處理的候選項目:那些看起來可以在沒有更多產品輸入的情況下修復/合併的項目,附帶 URL、符合資格的原因、所需的驗證以及信心。這是供審查的選擇,除非使用者同時要求自主執行,否則不是開始工作的許可。
  • 需要 Peter 決定:因 Peter/擁有者決策、產品方向、缺少憑證/存取權限、無法取得的即時提供者證明、安全/隱私判斷或 Peter 要求修改的權威評論而受阻的項目。
  • 延遲/關閉/取代:陳舊、重複、品質較低或重疊的項目,其預期的行動可能不是撰寫新程式碼。

對於每個看似合理的自主候選項目,當工具支援存在時,在提出它之前,使用可用的高推理子代理、oracle 或獨立代理審查來檢查可行性。僅提供任務相關的證據給子代理,並詢問該項目是否可以自主完成、需要哪些驗證以及哪些因素可能使其不安全。如果子代理不可用,則自行進行相同深度的檢查並說明。

自主工作模式

當使用者說 do work autonomously、work you can do autonomously、keep going 或類似內容時,不要僅在佇列摘要或一個本地修補程式後就停止。將其視為處理符合條件的 Issue/PR 佇列的權限,直到沒有安全的自主項目可處理、每個項目都已合併/關閉/延遲並附帶證據,或者遇到需要 Peter 介入的阻礙。

絕不同時處理多個工單。對於每個項目:

  1. 閱讀 Issue/PR、相關程式碼、文件、CI 和 VISION.md(如果存在);當事實可能過時或不清楚時,使用 Google/官方文件。
  2. 決定是否為自主處理:
    • 可以進行:效能改善(除非複雜度增加太多);具有重現步驟/根因和驗證路徑的錯誤修復;小型 UI/UX 調整;文件修復;狹義的測試/內部修復;具有綠色驗證的低風險依賴項/CI 清理。
    • 先詢問:新功能、產品/願景選擇、廣泛的行為變更、高風險依賴項、沒有強力證據的安全敏感變更、沒有可用憑證的即時提供者工作、任何無法進行端到端測試的內容。
    • 重構偏好:在對自主項目進行更好的修復時,選擇一個乾淨有邊界的重構;如果「小型修補程式」會留下更差的設計,則不要將其作為預設。
  3. 以最佳的可維護方式實作或修復 PR。當可寫入時,優先更新貢獻者的 PR;否則在本地重新建立並給予信用。
  4. 在可能的情況下,進行本地驗證和即時端到端驗證。對於 UI 行為,使用儲存庫預期的即時 UI 證明路徑,例如 Peekaboo、browser-use、螢幕截圖或 VM 證明。對於 API/提供者行為,在可用時,透過預期的秘密工作流程使用真實可用的金鑰/帳戶。如果缺少存取權限,請在假裝項目已完成之前停止,並請求 Peter 協助。
  5. 在提交/合併之前,執行 Codex 自動審查,除非是微不足道的/僅文件或明確跳過;處理已接受/可操作的發現。
  6. 確保 CI 為綠色、PR 描述/變更日誌良好、合併/關閉/評論並附帶證據,然後回到 main,執行 pull --ff-only,並在選擇下一個自主項目之前確認工作目錄乾淨。
  7. 在每個已合併的 PR 之後,發布一則 PR 評論,準確說明測試方式:本地命令、即時/UI/API 證明、CI 執行/檢查狀態、已合併的提交以及任何注意事項。如果驗證圖片適用,請在可用時使用 gh image 上傳/發布它們;如果上傳工具不可用,請說明並包含螢幕截圖路徑或替代的 GitHub 附件證明,而不是默默地省略圖片。

除非受阻,否則不要以髒文件或未推送的本地修復來結束自主模式。如果受阻,請說明確切的阻礙、當前分支/狀態、已收集的證據以及所需的下一個決定。

自主工作仍然受範圍限制:預設為當前儲存庫;僅在使用者要求廣泛/所有/全部或指名擁有者/組織時才處理廣泛/所有佇列。

信任訊號

對於每個你建議採取行動的非維護者項目,包含作者/開啟者的信任度。對於低風險的 Dependabot/內部項目,一條簡潔的機器人/內部信任行即可。

優先使用捆綁的輔助腳本:

skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>

如果此技能檢出缺少輔助腳本,則使用備用方案:

~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>

當 PR 需要更深入的信任判斷時,尤其是對於 OpenClaw、安全敏感變更、廣泛的 PR、新帳戶或異常的作者行為,也使用 github-author-context。首先優先使用現有的貢獻者註記:

~/Projects/maintainers/scripts/clawtributors find github <login>

信任輸出必須保持事實性:

信任: @login; 帳戶建立於 2021-04-03; 儲存庫 12 個月內 2 個 PR/1 個 Issue/0 個提交; GitHub 9 個 PR/3 個 Issue/12 個審查; 信號: 已知貢獻者 / 新路過者 / 機器人 / 未知。

不要將信任視為證明。它會改變審查深度,而非正確性。

項目評估

對每個項目進行分類:

  • bug:在可行時需要重現步驟/日誌/失敗測試/目前主分支證明;在建議修復/合併之前確定根本原因。
  • feature:需要端到端測試計畫。如果即時驗證需要提供者金鑰、帳戶、設備、服務、模型存取或付費 API,請在工作可以視為完成之前,準確說明缺少哪些憑證/存取權限。
  • dependency:解釋套件群組、主版本/次版本風險、失敗的檢查、執行時期/引擎變更以及是否要拆分。
  • security:提高優先級,需要仔細的程式碼路徑證明、測試和信任/上下文;不要僅基於理由就合併。
  • docs/internal:風險較低,但仍需解釋對使用者可見的相關性以及過時/產生內容的風險。

判斷:

  • 契合度:良好 / 混合 / 差,附帶一個理由。
  • 風險:低 / 中 / 高,附帶影響範圍。
  • 證明:當前 CI、本地重現、失敗測試、即時 E2E 或缺少證明。
  • 阻礙:首次貢獻者 CI 批准、失敗的檢查、缺少金鑰、不明確的產品方向、陳舊的分支、不可信/廣泛的差異、無法重現、衝突。
  • 下一步:批准 CI、執行測試、請求重現、拆分 PR、本地修補、綠色後合併、附帶證明關閉或延遲。

快速佇列地圖

僅當範圍廣泛時使用此功能。從儲存庫層級的佇列地圖開始。這會找到具有開放 Issue 和/或 PR 的儲存庫並給出數量。

PR 佇列,主要分類順序:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort prs \
  --json

Issue 壓力,當 Issue 重要時的第二次傳遞:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort issues \
  --json

僅在使用者說「全部」、「所有」或要求考古時才使用 --forks 和 --archived。預設分類應省略 fork 和已封存的儲存庫,除非它們的佇列特別相關。

對於精簡的終端機檢視:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain

有用的 jq 摘要:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
  jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'

在總結按 PR 排序的佇列時,保留 RepoBar 的 PR 計數順序。不要包含 PR 較少的儲存庫而省略同一擁有者範圍內 PR 較多的儲存庫。零 Issue 但具有開放 PR 的儲存庫,例如 openclaw/crabbox,仍然與分類相關。

詳細檢查

在廣泛的佇列地圖之後,僅檢查頂部的儲存庫,除非使用者明確想要詳盡的細節。

repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json

對於看起來可合併或可疑的 PR,切換到 gh 以獲得維護者等級的狀態:

gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10

對於可能已經修復的 Issue,切換到 gh issue view,然後在評論或關閉之前檢查當前的原始碼。

對於 OpenClaw/ClawdBot 佇列,在有用時使用 OpenClaw 維護者檢查:

  • 使用 gitcrawl(如果可用)搜尋重複/相關討論串;
  • 使用活動輔助腳本取得開啟者/作者身分;
  • 抑制頂級維護者的噪音,除非使用者要求維護者擁有的工作;
  • 優先考慮具有明確證據的外部/使用者回報的錯誤和 PR。

本地交叉檢查

當任務提及本地專案狀態、髒儲存庫或「我這裡擁有什麼」時使用此功能。

repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json

除非使用者明確要求,否則不要執行破壞性的本地操作(local reset、分支刪除、檢出移動)。

分類啟發式

優先處理:

  • 具有綠色或接近綠色 CI、近期維護者活動或低風險依賴項/文件/測試變更的 PR。
  • 開放 PR 數量多但有近期活動的儲存庫,因為它們通常隱藏著明顯的清理工作。
  • 可重現、近期回報或阻礙發布的 Issue。
  • 安全、發布、認證、安裝、CI 和資料遺失報告

…

Individual skills in this repo

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

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相關技能