finops-workflows

/finops:workflows

リポジトリの GitHub Actions ワークフロー実行を分析します。頻度、所要時間、成功率、効率性の指標を確認します。

使用するタイミング

シナリオ	このスキルを使用	代替手段
ワークフロー実行の頻度と所要時間を分析する	/finops:workflows	-
失敗率が高い原因を調査する	/finops:workflows	-
トリガーの種類の分布を把握する	/finops:workflows	-
組織全体のワークフローを分析する	/finops:workflows org <name>	-
全体的な健全性をすばやく確認する	/finops:overview	概要を把握するには overview を使用します
ワークフロー設定の問題を修正する	/finops:waste	実行可能な設定修正には waste を使用します
リポジトリ間でワークフローの指標を比較する	/finops:compare	複数リポジトリの比較には compare を使用します

コンテキスト

• 現在のリポジトリ URL： !git remote get-url origin

パラメーター

パラメーター	説明	デフォルト
repo	owner/name 形式のリポジトリ	現在のリポジトリ
--created	日付範囲フィルター（例：>=2026-03-01）	なし（直近の実行 100 件）
org <name>	組織全体の分析（repo の代わりに使用）	-

実行

リポジトリごとの分析（デフォルト）

bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS

組織全体の分析

組織全体の分析をユーザーがリクエストした場合は、組織用スクリプトを使用します。

bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS

出力形式

Analyzing workflows for: org/repo

=== Active Workflows ===
  CI (id: 12345)
  Deploy (id: 12346)
  CodeQL (id: 12347)

=== Run Summary ===
CI:
  Total: 156 | Success: 140 | Failure: 10 | Cancelled: 4 | Skipped: 2
  Success rate: 89%
Deploy:
  Total: 45 | Success: 44 | Failure: 1 | Cancelled: 0 | Skipped: 0
  Success rate: 97%

=== Duration Analysis ===
CI:
  Runs: 50 | Avg: 4m32s | Max: 12m15s | Total: 226min
Deploy:
  Runs: 20 | Avg: 2m10s | Max: 3m45s | Total: 43min

=== Trigger Types ===
  push: 89 runs
  pull_request: 67 runs
  schedule: 30 runs
  workflow_dispatch: 5 runs

=== Recent Failures (last 10) ===
  #234 CI - 2025-01-28 - https://github.com/org/repo/actions/runs/...
  #231 CI - 2025-01-27 - https://github.com/org/repo/actions/runs/...

=== High Frequency Workflows ===
  CI: 156 runs (~5.2/day) - consider path filters

エージェントによる最適化

コンテキスト	コマンド
ワークフロー一覧（JSON）	gh workflow list --json name,id,state
最近の実行（コンパクト）	gh run list --workflow <name> --limit 20 --json status,conclusion,createdAt
失敗した実行のみ	gh run list --status failure --limit 10 --json name,createdAt,url
実行時間（JSON）	`gh api "/repos/{owner}/{repo}/actions/runs?per_page=50" --jq '.workflow_runs[]
リポジトリごとのコンパクトな分析	bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS
組織全体の分析	bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS

実行後のアクション

調査結果に基づいて、次の対応を提案します。

• 失敗率が高い -> 最近の失敗を調査し、gh run view --log-failed でログを確認します
• 実行頻度が高い -> トリガー条件を見直し、パスフィルターを追加します
• 所要時間が長い -> キャッシュ、並列化、ステップの最適化を見直します
• スキップされた実行が多い -> 詳細な分析には /finops:waste を実行します