name: gh-workflow description: Sigumaa/calt リポジトリで GitHub Actions のワークフロー実行状況を gh workflow と gh run で確認・再実行・監視する運用スキル。CI失敗の原因切り分け、対象ジョブ再実行、実行ログ取得、push直後の最新run監視（gh run list --limit 1 → gh run watch RUN_ID --exit-status）を行う依頼で使用する。典型要求は「workflow一覧を見たい」「runを再実行したい」「失敗ジョブのログを確認したい」。Sigumaa/calt 以外のリポジトリ操作、gh 未認証環境での実操作、ワークフロー以外の実装作業には使用しない。

GitHub Workflow 運用スキル（Sigumaa/calt 限定）

Overview

• この skill は Sigumaa/calt の GitHub Actions 運用操作に限定して使う。
• 対応範囲は gh workflow と gh run を使う確認・監視・再実行・ログ確認である。
• --repo で他リポジトリを指定する操作は禁止する。

ワークフロー判定

• 次の依頼なら発火して処理する。
  • workflow 一覧や run 一覧を確認したい
  • 失敗 run のログを見たい
  • 対象 run を rerun / cancel したい
• 次の依頼は発火せず他手順へ委譲する。
  • Sigumaa/calt 以外の repository 操作
  • .github/workflows/*.yml の実装変更
  • gh secret や gh variable の管理
• 次の依頼は発火し、短い確認質問を返して判定する。
  • 対象 run_id / workflow 名が未指定
  • 認証状態が不明

実行手順

1. 対象リポジトリの固定

gh repo view --json nameWithOwner -q .nameWithOwner

• 結果が Sigumaa/calt 以外なら停止し、対象外として返答する。

1. 認証前提の確認

gh auth status

• github.com で有効なログインがない場合は実操作を中止する。
• 必要時の案内コマンド:

gh auth login --web --hostname github.com --git-protocol https

1. workflow 定義の確認（gh workflow）

gh workflow list
gh workflow view "<workflow-name-or-id>"

1. run 状態の確認（gh run）

gh run list --limit 20
gh run view <run-id>
gh run view <run-id> --log-failed

1. run の操作（必要時のみ）

gh run rerun <run-id>
gh run rerun <run-id> --failed
gh run cancel <run-id>
gh workflow run "<workflow-name-or-id>" --ref "<branch>"

• gh workflow run は対象 workflow と --ref を明示できる場合のみ実施する。

1. 補助情報の取得（必要時のみ）

gh run view <run-id> --job <job-id> --log
gh run download <run-id> --dir ./artifacts/<run-id>

1. push直後の最新run監視（必要時のみ）

gh run list --limit 1
gh run watch <run-id> --exit-status

• <run-id> は gh run list --limit 1 の出力にある最新 run の ID を指定する。

禁止事項

• Sigumaa/calt 以外の repository に対する gh workflow / gh run 操作。
• gh ... --repo <other-owner/other-repo> の使用。
• 認証未完了のまま rerun / cancel / workflow dispatch を実行すること。
• gh api を使った直接的な workflow 実行状態改変。
• ワークフロー運用を超える実装変更（コード編集、CI設計変更、権限設定変更）。

品質チェック

• 実行前に gh repo view と gh auth status の結果を確認する。
• 実行後は workflow名/run_id/実行コマンド/結果 を短く記録する。
• トリガーテストは references/trigger-test-log.md に追記する。
• skill更新後は次を実行して検証する。

uv run --with pyyaml python /home/shiyui/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/gh-workflow

• description を変更した場合は差分影響を記録する。

返答方針

• 返答は日本語で、実行した gh workflow / gh run コマンドを順序どおりに示す。
• 失敗時は失敗コマンド、原因、次の最小手順（例: 認証、対象指定）を分けて示す。
• 対象外依頼は「Sigumaa/calt 限定のため非対応」と明示して停止する。