Repository safety guide

必要最小限のリポジトリだけ接続する理由

Codex連携で作業範囲を広げすぎないために、対象リポジトリだけ接続する考え方をまとめます。

当サイトはOpenAIやGitHubの運営サイトではありません。CodexとGitHubを安全に使うための非公式ガイドです。
GitHubやCodexの画面、機能、連携方法は変わる可能性があります。最新情報が必要な場合は、各提供元が公開している情報を確認してください。
目次
  1. このページで分かること
  2. 全リポジトリ接続を避ける考え方
  3. 接続前の棚卸し
  4. Codex指示文例
  5. やってはいけないこと
  6. 最小権限チェックリスト
  7. 関連ページ

このページで分かること

必要最小限のリポジトリだけ接続する理由は、作業対象を明確にし、誤操作や情報混入の範囲を小さくするためです。全リポジトリ接続を前提にせず、作業対象だけに絞ることで、Codexへの指示も具体的になります。

全リポジトリ接続を避ける考え方

すべてのリポジトリへ広くアクセスできる状態は便利に見えますが、個人サイト、業務サイト、実験サイトが混在している場合は危険です。最初は確認用の小さなリポジトリから始め、必要な時だけ範囲を広げます。

接続前の棚卸し

接続前の棚卸しでは、今すぐ必要なリポジトリと、今回は関係ないリポジトリを分けます。後で使うかもしれないという理由だけで広げず、今回の作業に必要な範囲だけを選びます。

  • 作業対象リポジトリを1つに絞る
  • 本番サイトと実験サイトを分ける
  • 業務サイトと個人サイトを分ける
  • 不要な連携を外す
  • Secretsや接続情報がないか確認する
  • Codexに触らせる範囲を明記する
  • 停止条件を決める

Codex指示文例

この作業では、対象リポジトリだけを前提にしてください。他のリポジトリ、他サイト、認証情報、Secrets、接続情報、サーバー設定には触れないでください。対象外の情報が必要に見える場合は作業を止めて報告してください。

最小権限が効く理由

接続範囲を絞ることの価値は、「信用していないから」ではありません。間違いが起きた時に、被害の範囲がそこで止まるという点にあります。

状況全リポジトリに接続必要な分だけ接続
指示の対象を間違えた関係ないプロジェクトが変更される可能性接続していないものは触れない
認証情報が漏れたすべてのリポジトリが影響を受ける影響は接続済みの範囲に限られる
不要な情報が見える他の案件の内容も参照可能な状態関係ないものは最初から見えない
後から確認する時どこまで影響したか調べる範囲が広い調べる場所が限定される

最後の行も実務では大きな差になります。問題が起きた時、確認すべき範囲が狭いほど復旧が早くなります。全部につながっていると、無関係だと確かめるための作業まで発生します。

接続を見直すタイミング

一度設定すると、そのまま放置されがちです。次のタイミングで見直すと、不要な接続が溜まりません。

  • 案件やプロジェクトが終わった時:使わなくなった接続は、その場で外すのが最も確実です。
  • 新しく接続を追加する時:追加のついでに、既存の接続で不要なものがないか見ます。
  • 数か月に一度:定期的に一覧を眺めて、心当たりのない接続がないか確認します。

特に1番目を習慣にすると、棚卸しの手間がほとんどなくなります。終わった時に外す方が、後からまとめて整理するより判断が簡単です。時間が経つと「これはまだ使うかもしれない」と迷い、結局残すことになります。

なお、権限設定の画面や項目名はサービス側の更新で変わることがあります。実際の設定手順は、提供元の公式ドキュメントで現在の内容を確認してください。

やってはいけないこと

  • 最初から広い接続を前提にする
  • 作業対象を決めずに依頼する
  • 不要な連携を放置する
  • 本番サイトと実験サイトを同じ扱いにする
  • 秘密情報の確認を省く

最小権限チェックリスト

  • 対象リポジトリが明確
  • 必要な範囲だけ接続
  • 不要な連携を外した
  • 個人用と業務用を分けた
  • 秘密情報を確認した
  • 作業ブランチを使う
  • 人間が最終確認する

関連ページ