GHgithubguide.jp

GitHub Actionsのworkflowファイルとは？

workflowファイルは、GitHub Actionsで何をいつ実行するかを定義するファイルです。基本的にはリポジトリ内の .github/workflows/ に置かれ、変更すると自動実行や公開処理に影響することがあります。

このページでわかること

  • workflowファイルの場所と役割がわかる
  • name、on、jobs、stepsの考え方をつかむ
  • CodexやAIで修正する前に差分確認する理由がわかる

まず確認すること

  • 対象repoの .github/workflows/ を確認する
  • どのtriggerで動くか見る
  • Secretsやpermissionsを扱っていないか確認する

やってはいけないこと

  • 機密値をyamlへ直接書く
  • 動作確認なしに本番公開へつなげる
  • AIが出したworkflowをそのまま採用する

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さなbranchとPRに分け、CIとreviewで確認する。

CodexやAI作業時の注意

AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。

公式情報で確認する領域

Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。

関連ページ