Skip to content

docs: GitHub Copilot 学習利用オプトアウト手順書を追加#11

Merged
LevelCapTech merged 2 commits into
mainfrom
copilot/create-opt-out-procedure-docs
Apr 23, 2026
Merged

docs: GitHub Copilot 学習利用オプトアウト手順書を追加#11
LevelCapTech merged 2 commits into
mainfrom
copilot/create-opt-out-procedure-docs

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 23, 2026

概要(Summary)

このプルリクエストは GitHub Copilot の機械学習ポリシー変更に伴い、個人アカウントで学習利用を無効化する手順書を docs 配下に追加する対応 に沿った変更です。


背景・経緯(Context / Facts)

  • トリガーとなった事象(Issue / PR / 指摘 / 差分 等):2026年4月24日以降、Copilot Free / Pro / Pro+ でユーザー入力が既定で学習利用され得るため、オプトアウト手順の明文化が必要になった
  • 参照した情報・資料:GitHub Docs「Configuring your personal GitHub Copilot settings on GitHub.com」「Configuring GitHub Copilot in your environment」
  • 作業開始時点で確認できていた事実:既存 docs に当該手順書はなく、対象リポジトリの品質ゲートは Markdown 中心だった

変更のインデックス(どのファイルをどう変えたか)

diffの目次(ファイル×変更概要)を下記のテーブルに記載します。

ファイル 変更概要
docs/copilot/opt-out-guide.md Copilot 学習利用オプトアウト手順書を新規追加

設計判断 / トレードオフ

コードの差分(Diff)からは読み取れない「設計判断(Trade-off)」を記録します(例:なぜプランAではなくプランBを採用したか)。必要なだけ行を追加します。

判断テーマ プランA プランB 採用プラン 採用理由(事実/制約/評価軸) 不採用理由(トレードオフ) 根拠(Issue/Doc/測定/差分)
UI 導線の記述 Settings > Copilot のみ記載 Copilot settings を主導線にし、Settings > Copilot を補足 プランB GitHub Docs の現行表記は Copilot settings。一方で issue 要件は Settings > Copilot を前提としているため両対応にした 単一路線だと UI 差分で読者が迷う Issue 要件、GitHub Docs
IDE 記載の深さ IDE ごとの詳細手順まで記載 GitHub.com 側が正であることだけ補足 プランB 問題の主対象は Web UI のオプトアウト。不要な枝葉を増やさず、設定の所在だけ明確化した IDE 別詳細を足すと保守負荷が上がる Issue の In Scope / Out of Scope、GitHub Docs

適用後に観測できる結果(観測ログ/確認ログ)

確認ログ(何を実行/何を目視したか)を下記のテーブルに記載します。

確認項目 方法(実行/目視) 結果 根拠(ログ/URL/スクショ等)
手順書の情報源整合 目視 GitHub Docs の現行 UI 名称と整合する内容になっている https://docs.github.com/en/copilot/configuring-github-copilot/configuring-your-personal-github-copilot-settings-on-githubcom
手順書の可読性 目視 見出し、手順、例外条件、IDE 補足が 1 ページで追える ローカル HTML プレビューで確認

エラーハンドリング・境界値の考慮事項(Error Handling / Boundary Conditions)

異常系(エラー時)および境界値(Boundary Condition)について、考慮したケースと確認結果を下記のテーブルに記載します。必要なだけ行を追加します。

分類(error/boundary) ケース(入力/条件) 期待動作(仕様) 実装上の扱い(例外/戻り値/ログ/抑止) 確認方法(実行/目視/テスト) 結果 根拠(ログ/URL/スクショ等)
error 学習設定項目が表示されない 想定原因を案内し、利用者が切り分けできる Business / Enterprise、UI 変更、別アカウントの可能性を明記 目視 対応済み docs/copilot/opt-out-guide.md
boundary UI 導線が issue 記載と実画面で異なる どちらの導線でも到達できる説明にする Copilot settings 主導線 + Settings > Copilot 補足 目視 対応済み docs/copilot/opt-out-guide.md
boundary IDE 側設定と GitHub.com 側設定が混同される 主設定箇所を誤認しない IDE は補足に限定し、GitHub.com 側がオプトアウト本体であることを明記 目視 対応済み docs/copilot/opt-out-guide.md

影響範囲(どこに影響しないと言える根拠)

影響対象 結論 根拠
アプリケーション挙動 影響なし 実行コード・設定値・依存関係を変更していない
環境設定・デプロイ手順 影響なし docs 追加のみで既存の開発/運用手順は変更していない

依存関係とコストへの影響(Dependencies / Cost Impact)

外部依存(ライブラリ/外部サービス/API)およびコスト(課金・パフォーマンス)への影響を下記のテーブルに記載します。必要なだけ行を追加します。

観点 対象(ライブラリ/サービス/API 等) 変更内容(追加/更新/削除/呼出増減 等) 影響(課金/性能/運用) 影響量(増減の見積/測定値) 根拠(計測/ログ/設定/差分)
依存 ライブラリ / サービス 変更なし 影響なし 0 差分は Markdown 1 ファイルのみ
コスト 実行性能 / 課金 変更なし 影響なし 0 実行パスに変更なし
運用 docs 保守 手順書を 1 ファイル追加 UI 変更時に更新が必要 軽微 Issue 記載の運用性要件どおり

スコープ境界(触っていい/ダメ、非目標)

区分 範囲(パス/モジュール/設定など) 根拠
触ってよい範囲 docs/copilot/**/*.md Issue の In Scope が docs 配下への手順書追加
触ってはいけない範囲 アプリコード、ワークフロー、依存関係、契約/管理設定 Issue の Out of Scope
非目標 Enterprise 管理機能、API 制御、契約変更、自動化 問題文に明記

推論せず“質問に落とす”ための質問票

判断が必要な箇所を下表にまとめます。(決定事項を確認するADR)

論点 / 質問 回答(事実のみ) 根拠(Issue/PR/Commit/ファイル等)
このPRで「決定」扱いにしたいことは何か?(なければ空欄) 個人向け Copilot 学習利用オプトアウト手順の最小構成 docs/copilot/opt-out-guide.md
触ってよい範囲(パス/モジュール/設定) docs 配下の手順書追加 Issue の In Scope
触ってはいけない範囲(パス/モジュール/設定) 実行コード、組織強制ポリシー、契約、API 制御 Issue の Out of Scope
非目標(このPRではやらないこと) Enterprise 管理手順や IDE 詳細手順の網羅 問題文、差分内容
成功条件(何が確認できればOKか) 読者が GitHub.com 上で学習利用を無効化できる 受け入れ条件、追加 docs
不確定点(質問として列挙) 今後の UI 項目名変更の有無 GitHub 側 UI 変更に依存
追加質問(必要に応じて追記) なし -

実装と確認のログ(何を触って、何を確認したか)

項目 記録
触った主要箇所(パス/関数/クラス等) docs/copilot/opt-out-guide.md
実装メモ(変更意図ではなく事実) オプトアウト対象、前提条件、Web UI 手順、未表示時の分岐、IDE 補足、参考リンクを記載
実行した確認(コマンド/手動操作/ログ等) GitHub Docs の参照、Markdown レンダリング確認
既知の未確認点(あれば) GitHub UI の将来変更は追随更新が必要

実行区分(AIが実行したこと/人間が追加で行うこと)

同一フォーマットで、必要なだけ行を追加します。

区分 タスク(何をする) 対象(どのサイト/システム) 実行場所(URL/画面/コマンド) 実行方法(どうやって) 入力(必要な情報) 出力(得られるもの/保存先) 証跡(ログ/URL/スクショ等)
AI 公式仕様確認 GitHub Docs docs 記事 Web 参照 Copilot 個人設定 URL 手順の一次情報 GitHub Docs URL
AI 手順書追加 リポジトリ docs docs/copilot/opt-out-guide.md Markdown 作成 Issue 要件、公式仕様 手順書 Git 差分
AI レンダリング確認 ローカルプレビュー HTML プレビュー 目視 追加 Markdown 可読性確認結果 ローカル確認
人間 実アカウントで設定変更 GitHub.com Copilot settings 画面 手動操作 認証済み GitHub アカウント オプトアウト反映 GitHub 設定画面
人間 契約プラン確認 GitHub.com Copilot plan / billing 画面 手動確認 利用中アカウント Free / Pro / Pro+ 該当性 GitHub 画面
人間 UI 変更時の追補 リポジトリ docs docs/copilot/opt-out-guide.md 文書更新 現行 UI 更新された手順書 後続 PR
人間 Business / Enterprise との差分判断 組織運用 管理設定 手動判断 組織契約情報 対象外判断または別手順 組織ポリシー
人間 IDE 補助設定の確認 VS Code / JetBrains IDE 設定画面 手動確認 利用 IDE 補助設定の整合 IDE 画面
人間 社内案内への転記 社内ドキュメント 任意の運用媒体 手動転記 本 PR の docs 運用周知 社内文書
人間 定期レビュー リポジトリ docs 更新サイクル 定期確認 GitHub UI の変更有無 docs の鮮度維持 保守運用ログ
人間 スクリーンショット再取得(必要時) GitHub.com 実画面 手動取得 日本語表示可能な環境 PR 添付画像 任意添付

生成コードの利用方法(どうやって使うか)

形式A: テーブル

AIが生成したコード(生成物)の利用方法を下記のテーブルに記載します。

対象(生成物) 種別(コード/設定/スクリプト等) 配置(パス/モジュール) 呼び出し元(どこから使う) 使い方(設定/呼び出し/実行手順) 入力(必要な値/前提) 出力(得られる結果/保存先) 確認方法(どう確かめる)
opt-out-guide.md ドキュメント docs/copilot/opt-out-guide.md リポジトリ閲覧者 docs を開いて手順どおりに操作する GitHub ログイン済みアカウント 学習利用無効化の操作手順 GitHub.com で設定変更できる
opt-out-guide.md 参照資料 docs/copilot/opt-out-guide.md 開発者 / 管理者 例外ケースや注意事項を確認する 契約プラン、利用 UI 判断材料 項目未表示時に切り分けできる
GitHub Docs リンク 外部参照 文書末尾 手順書読者 公式情報を追う インターネット接続 最新仕様 docs の参考情報リンク

形式B: コードサンプル

利用手順をコード(またはコマンド)で提示します。必要に応じてブロックを追加します。

# opt-out-guide.md の利用例(コマンド)
# 前提: リポジトリを参照できる
# 実行場所: リポジトリルート

cat docs/copilot/opt-out-guide.md
// 該当なし

セキュリティチェック (Security Self-Check)

  • Secrets: コード内にAPIキーやパスワードが含まれていないことを確認した
  • Input Validation: 外部からの入力値(API引数/フォーム)を検証している
  • Access Control: 認可(権限チェック)ロジックに抜け穴がない

補足(Notes)

  • 変更は docs 1 ファイルの追加のみ
  • 問題の主対象は個人アカウント設定であり、組織強制ポリシーは対象外
  • 手順は GitHub Docs の現行表記に寄せている
  • Settings > Copilot 前提の読者も迷わないよう導線を補足した
  • 提供されたスクリーンショット URL は日本語表示の可読性が低く、本文には採用していない
  • UI 文言変更時は本ファイルの更新で追随する想定

コードレビューフィードバック対応(Review Feedback Response)

このセクションは「追記」で管理します。

追記(今回分)

  • フィードバック(要約):自動レビュー指摘なし 対応(何を変えた):追加対応なし 対象(ファイル/行/Commit):PR 全体 状態(対応済)
  • フィードバック(要約):CodeQL 対象コード変更なし 対応(何を変えた):追加対応なし 対象(ファイル/行/Commit):PR 全体 状態(対応済)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)
  • フィードバック(要約):<> 対応(何を変えた):<> 対象(ファイル/行/Commit):<> 状態(対応済/保留/却下)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • github.blog
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI changed the title [WIP] Add opt-out procedure documentation for Copilot docs: GitHub Copilot 学習利用オプトアウト手順書を追加 Apr 23, 2026
Copilot AI requested a review from LevelCapTech April 23, 2026 07:51
@LevelCapTech LevelCapTech marked this pull request as ready for review April 23, 2026 07:54
@LevelCapTech LevelCapTech merged commit c266094 into main Apr 23, 2026
6 of 9 checks passed
@LevelCapTech LevelCapTech deleted the copilot/create-opt-out-procedure-docs branch April 23, 2026 08:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BLIND] GitHub Copilot 機械学習ポリシー変更に伴うオプトアウト手順書の作成

2 participants