GitHubチーム運用の安全チェックリスト
GitHubをチームで使う時は、権限、Secrets、review、Actions、外注、退職者対応を定期的に確認します。このページは第7波のチェックリストハブです。
このページでわかること
- repo権限と管理権限を見直す
- main、PR review、CI/Actions、Secretsを確認する
- 外注先や退職者のアクセスを見直す
まず確認すること
- PR review担当がいるか見る
- CODEOWNERSやtemplateが必要か検討する
- Codex/AI作業のreview担当を決める
やってはいけないこと
- チェックリストだけで万能と考える
- 広い権限を放置する
- 安全性を保証する表現にする
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さな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の説明と照合してください。