AgentSkillsCN

gh-workflow

在 Sigumaa/calt 仓库中，利用 `gh workflow` 和 `gh run` 查看、重新执行并监控 GitHub Actions 工作流的运行状态，掌握相关运维技能。当接到请求需要排查 CI 失败原因、重新执行指定作业、获取运行日志，以及在推送后立即监控最新运行（先用 `gh run list --limit 1` 获取最近一次运行，再用 `gh run watch RUN_ID --exit-status` 进行实时监控）时，可使用此技能。典型需求包括：“想查看工作流列表”、“想重新执行某个运行”、“想查看失败作业的日志”。请勿在 Sigumaa/calt 以外的仓库中使用该技能，也不要在未通过 `gh` 认证的环境中直接操作，更不得用于工作流之外的其他实现任务。

SKILL.md
--- frontmatter
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. •対象リポジトリの固定
bash
gh repo view --json nameWithOwner -q .nameWithOwner
  • •結果が Sigumaa/calt 以外なら停止し、対象外として返答する。
  1. •認証前提の確認
bash
gh auth status
  • •github.com で有効なログインがない場合は実操作を中止する。
  • •必要時の案内コマンド:
bash
gh auth login --web --hostname github.com --git-protocol https
  1. •workflow 定義の確認（gh workflow）
bash
gh workflow list
gh workflow view "<workflow-name-or-id>"
  1. •run 状態の確認（gh run）
bash
gh run list --limit 20
gh run view <run-id>
gh run view <run-id> --log-failed
  1. •run の操作（必要時のみ）
bash
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. •補助情報の取得（必要時のみ）
bash
gh run view <run-id> --job <job-id> --log
gh run download <run-id> --dir ./artifacts/<run-id>
  1. •push直後の最新run監視（必要時のみ）
bash
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更新後は次を実行して検証する。
bash
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 限定のため非対応」と明示して停止する。