GitHub プロジェクト トリアージ
ユーザーが triage と入力した場合は、リクエストが明示的に GitHub 以外のドメインを対象としていない限り、常にこのスキルを使用して下さい。リポジトリ内からは、デフォルトで現在の GitHub プロジェクトを使用します。トリアージとは、メンテナー向けのアイテムカードを意味します。URL、各 Issue/PR の内容、重要性、著者の信頼度、適合性、リスク、証拠/テスト状態、ブロッカー、次のアクションを含めてください。キュー番号だけや不透明な参照のみを返さないで下さい。
出力は URL 優先です。表示されるすべての Issue/PR/リポジトリアイテムは、そのアイテムの最初の行または最初の文に GitHub URL を含める必要があります。簡易リストを表示する場合は、アイテムごとに 1 つの 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 コメントによってブロックされているアイテム。延期/クローズ/取って代わられた: 古い、重複、品質が低い、または重複するアイテムで、新しいコード以外のアクションが考えられるもの。
すべての妥当な自律候補について、ツールのサポートが存在する場合、利用可能な高推論サブエージェント、オラクル、または独立したエージェントレビューを使用して、提示する前に実現可能性を確認して下さい。サブエージェントにはタスクローカルの証拠のみを与え、アイテムが自律的に完了できるかどうか、どのような検証が必要か、何が安全でなくなる可能性があるかを尋ねて下さい。サブエージェントが利用できない場合は、同じ深さを自分自身で行い、その旨を述べて下さい。
自律作業モード
ユーザーが do work autonomously、work you can do autonomously、keep going などと言った場合、キューの概要や 1 つのローカルパッチで止まらないで下さい。安全な自律アイテムが残っていないか、各アイテムが証拠付きでランディング/クローズ/延期されるか、ブロッカーが Peter を必要とするまで、適格な Issue/PR キューを順次処理する許可として扱って下さい。
一度に複数のチケットを決して処理しないで下さい。各アイテムについて:
- Issue/PR、関連コード、ドキュメント、CI、
VISION.md(存在する場合)を読んで下さい。事実が古いか不明確な可能性がある場合は Google/公式ドキュメントを使用して下さい。 - 自律可能かどうかを判断して下さい:
- 進める(Go): 複雑さが上がりすぎない限りパフォーマンス改善。再現/根本原因と検証パスがあるバグ修正。小さな UI/UX 調整。ドキュメント修正。狭いテスト/内部修正。緑の証拠がある低リスクの依存関係/CI クリーンアップ。
- 最初に確認する(Ask first): 新機能、製品/ビジョンの選択、広範な動作変更、リスクの高い依存関係、強い証拠なしのセキュリティ関連変更、使用可能な資格情報なしのライブプロバイダー作業、エンドツーエンドでテストできないもの。
- リファクタリングの優先: 自律アイテムに対するより良い修正である場合、クリーンで境界のあるリファクタリングを選択して下さい。デフォルトとして「小さなパッチ」を使用せず、それがより悪い設計を残す場合。
- PR を最良の保守可能な方法で実装または修正して下さい。書き込み可能であればコントリビューターの PR を更新することを優先し、それ以外はクレジットを付けてローカルで再作成して下さい。
- 可能であればローカルおよびライブでエンドツーエンドに検証して下さい。UI 動作については、Peekaboo、browser-use、スクリーンショット、VM 証明など、リポジトリの期待されるライブ UI 証明パスを使用して下さい。API/プロバイダー動作については、利用可能な場合、期待されるシークレットワークフローを通じて実際の使用可能なキー/アカウントを使用して下さい。アクセスが不足している場合は、アイテムが完了したふりをせずに停止し、Peter に助けを求めて下さい。
- コミット/ランディング前に Codex 自動レビューを実行して下さい。ただし、些細なもの/ドキュメントのみの場合や明示的にスキップされた場合は除きます。受け入れられた/実行可能な調査結果に対処して下さい。
- CI がグリーンであること、PR の説明/変更履歴が良好であることを確認し、証拠付きでランディング/クローズ/コメントしてから、
mainに戻り、pull --ff-onlyを実行し、次の自律アイテムを選択する前にクリーンなワークツリーを確認して下さい。 - すべてのランディングされた PR の後で、PR コメントを投稿し、テスト方法を正確に説明して下さい。ローカルコマンド、ライブ/UI/API 証明、CI 実行/チェック状態、ランディングされたコミット、および注意点。検証画像が該当する場合は、利用可能な場合は
gh imageでアップロード/投稿して下さい。アップローダーが利用できない場合は、その旨を述べ、画像を黙って省略する代わりに、スクリーンショットのパスまたは代替の GitHub 添付ファイルの証明を含めて下さい。
ブロックされない限り、ダーティファイルやプッシュされていないローカル修正で自律モードを終了しないで下さい。ブロックされた場合は、正確なブロッカー、現在のブランチ/ステータス、既に収集された証拠、および次に必要な決定を述べて下さい。
自律作業は依然としてスコープによって制限されます。デフォルトでは現在のリポジトリ。ユーザーが broad/all/everything を要求したか、所有者/組織を指定した場合のみ、ブロード/全キュー。
信頼シグナル
行動を推奨するすべての非メンテナーアイテムについて、著者/オープナーの信頼度を含めて下さい。低リスクの Dependabot/内部アイテムについては、簡潔な bot/内部の信頼ラインで十分です。
バンドルされたヘルパーを優先して下さい:
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 レビュー; シグナル: 既知のコントリビューター / 新しいドライブバイ / ボット / 不明。
信頼を証明として扱わないで下さい。それはレビューの深さを変えますが、正確性は変えません。
アイテム評価
各アイテムを分類して下さい:
バグ: 可能な場合は再現/ログ/失敗テスト/現在のメインの証明を要求し、修正/マージを推奨する前に根本原因を特定して下さい。機能: エンドツーエンドのテスト計画を要求して下さい。ライブ検証にプロバイダーキー、アカウント、デバイス、サービス、モデルアクセス、有料 API が必要な場合は、作業が完了したと見なされる前に不足している資格情報/アクセスを正確に述べて下さい。依存関係: パッケージグループ、メジャー/マイナーリスク、失敗チェック、ランタイム/エンジンの変更、分割すべきかどうかを説明して下さい。セキュリティ: 優先度を上げ、注意深いコードパスの証明、テスト、信頼/コンテキストを必要とします。理由だけでのマージはしないで下さい。ドキュメント/内部: リスクは低いですが、それでもユーザーに見える関連性と、古くなった/生成されたチャーンのリスクを説明して下さい。
判断して下さい:
適合性: 良好 / 混合 / 不良、理由を 1 つ。リスク: 低 / 中 / 高、影響範囲。証拠: 現在の 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 は、ユーザーが "all"、"everything" と言った場合、または考古学を要求した場合にのみ使用して下さい。デフォルトのトリアージでは、フォークとアーカイブされたリポジトリは、そのキューが特に関連する場合を除き、省略して下さい。
コンパクトなターミナルビューの場合:
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、データ損失の報告。
…
[翻訳のために切り詰め]