GitHubチーム運用の安全チェックリスト

GitHubをチームで使う時は、権限、Secrets、review、Actions、外注、退職者対応を定期的に確認します。このページは第7波のチェックリストハブです。

このページでわかること

  • repo権限と管理権限を見直す
  • main、PR review、CI/Actions、Secretsを確認する
  • 外注先や退職者のアクセスを見直す

まず確認すること

  • PR review担当がいるか見る
  • CODEOWNERSやtemplateが必要か検討する
  • Codex/AI作業のreview担当を決める

やってはいけないこと

  • チェックリストだけで万能と考える
  • 広い権限を放置する
  • 安全性を保証する表現にする

安全寄りに進める手順

  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で最新の説明を確認してください。

関連ページ

チームの安全確認を、担当と変更内容から進める

権限、Secrets、review、Actionsを確認する時は、対象のrepo、branch、PR、Actions runをそろえ、誰が変更し、誰が確認するかを整理します。設定の名前を追うだけでなく、今回の作業範囲と担当者を結び付けて見ると、確認すべき場所を絞れます。この面の情報だけでは、チームの現在の権限や設定状況は不明です。実際の状態と照らし合わせて使ってください。

権限とreview担当は一緒に確認する

まず、repo権限と管理権限を確認し、外注先や退職者、契約が終了した相手のアクセスも見直します。広い権限が残っている場合は、その担当者が今扱う作業と照らして検討します。続いて、mainへの変更を確認するPR review担当と、CodexやAIが作った差分を確認する担当を整理します。CODEOWNERSやtemplateを使うか迷う時も、先に「誰が何を見るか」を決め、その確認を支えるために必要かを考えます。

差分とActionsのログを続けて見る

変更内容を読む時は、Secrets、APIキー、token、.env、個人情報が差分に混ざっていないか確認し、関連するActions runのログも見ます。混入の疑いがある場合は、commitやpushを急がず、対象ファイル、公開範囲、履歴への混入有無を確認します。必要に応じて値の停止や再発行を行い、影響範囲を整理します。確認のためにIssueやPR説明へ実際のキー値を貼ることは避けます。

確認結果を次のreviewへつなぐ

変更は小さなbranchとPRに分け、CIと人間のreviewで確認します。AIへ渡す依頼には対象ファイル、触らないファイル、確認項目を明記し、引き継ぐ時には未完了項目も整理します。チェック済みという記録だけで判断せず、未確認の箇所は「不明」として残します。ActionsやSecrets、公開範囲、workflow permissionsの仕様に関わる判断は、実作業前にGitHub Docsの説明と照合してください。