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