mcpField
C
clawsweeper-status

clawsweeper-status

github.com/steipeteクラウド・DevOps7.4k95 回インストール1 週間前に更新
リポジトリ

clawsweeper-status について

同梱スクリプトを実行し、対象リポジトリの ClawSweeper ワークフローとキューの状態を報告するスキルです。最近のリポジトリアクティビティを整理し、キュー状態と容量情報を説明します。

主な機能

  1. 01ワーカーとワークフロー状態の報告
  2. 02キューの健全性とバックオフの要約
  3. 03公開キュー指標の表示
  4. 04最近のマージ、レビュー、コメントの一覧
  5. 05リポジトリ、期間、行数の指定

活用シーン

  1. 01リポジトリの ClawSweeper 活動を確認する
  2. 02オペレーター対応待ちの停留項目を特定する
  3. 03最近マージまたはクローズされた項目を確認する
  4. 04キュー容量とリトライ状況を調べる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steipete/agent-scripts --skill clawsweeper-status

インストール後、Claude Code で/clawsweeper-statusを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
scripts/
clawsweeper-status.sh
clawsweeper-status.test.sh
scripts/fixtures/
public-exact-review-queue.json

詳細

ClawSweeper のステータス

クイックスタート

まず、同梱のステータススクリプトを実行します。

/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh

便利なオプション:

# Last 10 hours for the default target repo, openclaw/openclaw
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --hours 10

# A different target repo
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --repo openclaw/clawhub

# More rows per activity section
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --limit 15

出力の仕様

次のセクションを簡潔に報告します。

  • Workers:ワークフローの状態、設定済みの上限に対する Codex ジョブ数、利用可能な場合は厳密レビューキューと目標占有率、アクティブなワークフローグループ。公開キューの集計情報は、非公開の目標占有率がなくても引き続き利用できます。occupancy unavailable はゼロを意味しません。
  • Queue health:healthy でない場合は、最初に報告します。保留中の件数だけでは判断できません。その下にスクリプトが出力する内訳を確認します。
    • ready/admissible がほぼゼロで、保留中の件数が多い場合、そのレーンは項目を意図的に保留しており、停止しているわけではありません。
    • Queue backoff: throttle_retry N は、GitHub によってレート制限されていることを意味します。クォータが回復すると、レーンは自動的に復旧します。
    • Queue parked (needs operator): review_retry_exhausted N は自動復旧しません。保留項目は5分、10分、20分後に再試行され、その後は人による対応を待ちます。必ず明示的に報告してください。
    • Shed since reset が数千件に増えている場合、一時的な急増ではなく、継続的な過負荷を示しています。
  • Publication tail:利用可能な場合は、保留中/実行可能/バックオフ中/保留措置済み/アクティブの合計件数と上限、さらに再試行理由と保留措置の理由。これはレビューのバックログとは別のもので、ターゲットごとのアクティビティではありません。このレーンに対応していない従来のレスポンスでは unavailable と報告されます。
  • Recently merged:マージ済み PR の URL と1行のタイトル。
  • Recently reviewed:ClawSweeper/Codex のレビューコメントの URL と1行のコメント要約。
  • Recently commented:ClawSweeper によるその他の最近のコメントの URL と1行のコメント要約。
  • Recently closed:クローズされた issue/PR の URL と1行のタイトル。

あるセクションでスクリプトから行が返されない場合は、none found in window と報告します。

アクティブなワークフローグループは、実行回数の降順で最大20件に制限されます。アクティビティの各セクションは --limit の件数に制限されます。ワークフローのスナップショットが大きい場合でも、すべてのアクティビティセクションを取得してください。必須の取得/解析に失敗した場合は、処理を失敗とします。キューや上限のテレメトリは、任意項目のため利用できないままでもかまいません。

効率的なデータソース

範囲を絞った API 呼び出しを使用するため、スクリプトを優先してください。

  • openclaw/clawsweeper のフィールドを絞った Actions 実行クエリと、範囲を絞ったアクティブジョブの確認。
  • 容量の把握に使う、小規模な自動化制限設定と厳密レビューキューのステータスエンドポイント。
  • レビュー/コメントの URL を取得するための最近の issue コメント。
  • クローズ済み項目の URL と実行者を取得する、フィールドを絞った検索。
  • フィールドを絞った最近のマージ済み PR。

これらの確認にウェブブラウジングを使用しないでください。gh を直接使用してください。

解釈

  • リポジトリへのディスパッチによるレビュー実行がキャンセルされた場合、通常は同じ項目に対する新しいイベントが届いたことによる、想定内の置き換えです。
  • Codex の使用状況は、実際に進行中またはキューに入っているジョブから数えます。セットアップアクションのステップと既知のレーン名を使って、Codex の作業を特定します。
  • pending 状態のワークフロー実行は、同時実行枠を待つものとして扱い、キューに入った Codex ジョブとは見なしません。
  • 古いワーカー数は慎重に扱います。数値が一致しない場合は、ステータスで絞り込んだ gh run list の結果と、既定の最近の実行一覧を比較します。
  • キューの読み取りでは認証を行いません。公開されている最古の保留項目の経過時間は、非公開の項目キーがなくても有用です。ヘルス件数がない場合は、ゼロではなく unknown とします。
  • 最終回答では GitHub の完全な URL を使用します。

コメント