GitHub Copilotの設定 - プランモードのソースを表示

== 概要 ==
GitHub Copilotのプランモードは、ソースコード実装の前に詳細な計画を作成し、レビューするための機能である。<br>
<br>
プランモードは、コードベースを分析し、タスクを実行可能なステップに分解して、ユーザの承認を得てから実装を開始する。<br>
この機能により、複雑な変更やリファクタリングを安全かつ効率的に実行できる。<br>
<br>
プランモードの主な特徴を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ プランモードの主な特徴
! 特徴 !! 説明
|-
| コードベースの分析 || プロジェクト構造と依存関係を理解
|-
| タスクの分解 || 実行可能なステップに細分化
|-
| マークダウン形式での計画表示 || 読みやすい形式で計画を提示
|-
| ユーザへの確認質問機能 || ask_userツールによる要件の明確化
|-
| 計画のレビュー・承認フロー || ユーザが承認するまで実装を開始しない
|-
| 読み取り専用の分析フェーズ || 計画が承認されるまでコード変更を行わない
|}
</center>
<br>
プランモードを使用することにより、以下に示すメリットが得られる。<br>
* 安全性の向上
*: 実装前に影響範囲を把握できる。
* 品質の向上
*: 詳細な計画により実装の精度が向上する。
* リスクの低減
*: 事前に問題点を特定できる。
* コミュニケーションの改善
*: チーム内で計画を共有・議論できる。
* トークンの節約
*: 無駄な試行錯誤を避けられる。
<br><br>

== 対応環境 ==
GitHub Copilotのプランモードは、複数の開発環境で利用可能である。<br>
<br>
<center>
{| class="wikitable"
|+ プランモード対応環境
! 開発環境 !! 対応バージョン !! 提供形態
|-
| VS Code || 最新版 || Copilot拡張機能
|-
| Visual Studio 2022 || version 17.14以降 || Copilot拡張機能
|-
| JetBrains IDEs || 最新版 || Copilot拡張機能
|-
| Eclipse || 最新版 || Copilot拡張機能
|-
| Xcode || 最新版 || Copilot拡張機能
|-
| Copilot CLI || 2026年1月21日アップデート以降 || コマンドラインツール
|}
</center>
<br>
JetBrains IDEには、IntelliJ IDEA、PyCharm、WebStorm等が含まれる。<br>
<br><br>

== VS Codeでの使用方法 ==
==== プランモードの開始 ====
# Chat viewを開く。
#* Windows / Linux
#*: [Ctrl] + [Alt] + [I]キー
#* Mac
#*: [Command] + [Control] + [I]キー
#: <br>
# エージェントドロップダウンから[Plan]を選択する。
#: <br>
# 高レベルのタスク説明を入力する。
#* 機能追加
#* リファクタリング
#* バグ修正
#: <br>
# プロンプトを送信する。
<br>
==== プラン案のレビュー ====
Copilotが提案したプラン案をレビューし、フィードバックを提供する。<br>
<br>
* ステップの妥当性
*: 各ステップが適切に分解されているか
* 影響範囲の確認
*: 想定外のファイルが含まれていないか
* 依存関係の確認
*: 変更の順序が適切か
* リスクの評価
*: 潜在的な問題がないか
<br>
フィードバックの例を以下に示す。<br>
* このステップは不要です。
* データベーススキーマの変更も必要です。
* 既存のテストが壊れる可能性があります。
* 段階的に実装してください。
<br>
==== 実装の開始 ====
計画を承認したら、以下に示す方法で実装を開始することができる。<br>
<br>
* 実装ボタンの使用
*: 同じチャットセッション内で実装を開始する。
* バックグラウンドエージェントセッション
*: バックグラウンドで実装を実行する。
* クラウドエージェントセッション
*: クラウド上で実装を実行する。
<br>
==== Todoリスト機能 ====
複雑なタスクでは、AIが自動的にTodoリストを作成して進捗を追跡する。<br>
<br>
Todoリストの機能:<br>
* タスクの自動分解
*: 大きなタスクを小さなステップに分割
* 進捗の追跡
*: 完了したステップをマーク
* 依存関係の管理
*: ステップ間の依存関係を追跡
* 視覚的なフィードバック
*: 進捗状況を視覚的に表示
<br><br>

== Visual Studioでの使用方法 ==
==== 対象バージョン ====
Visual Studio 2022 version 17.14以降がプランモードに対応している。<br>
<br>
==== プランモードの有効化 ====
# [ツール]メニューバー - [オプション]を選択する。
# [GitHub] - [Copilot]セクションを展開する。
# [Enable Planning]チェックボックスにチェックを入力する。
# [OK]ボタンを押下する。
<br>
==== プランモード用ツール ====
Visual Studioのプランモードでは、以下に示すツールが使用される。<br>
<br>
<center>
{| class="wikitable"
|+ プランモード用ツール
! ツール名 !! 説明
|-
| plan || ユーザリクエストから初期構造化プランを生成
|-
| adapt_plan || 新しいコンテキストやフィードバックに基づいてプランを調整
|-
| update_plan_progress || ステップ完了状態を更新し計画状態を同期
|-
| record_observation || 実行時の結果や洞察をキャプチャ
|-
| finish_plan || 全てのステップ完了後にプランを完了化
|}
</center>
<br>
==== マークダウンプランとJSONプラン ====
Visual Studioのプランモードでは、2種類のプラン形式が使用される。<br>
<br>
* ユーザ向けマークダウンプラン
*: 目標と進捗を読みやすい形式で表示
*: ユーザとのコミュニケーションに使用
* 内部JSONプラン
*: LLMが読める形式で段階追跡と推論を管理
*: システム内部での処理に使用
<br>
プランファイルは、一時的に以下のディレクトリに保存される。<br>
* C:\Users\<ユーザ名>\AppData\Local\Temp\VisualStudio\copilot-vs
<br><br>

== JetBrains IDEでの使用方法 ==
==== 前提条件 ====
JetBrains向けのCopilotプラグインの最新版が必要である。<br>
<br>
==== プランモードの開始 ====
# Copilot Chatパネルを開く。
#: 右側の[GitHub Copilot Chat]アイコンを選択する。
# パネル下部のエージェントドロップダウンから[Plan]を選択する。
# タスク説明を入力する。
#: 例: Create a simple to-do web app with HTML, CSS, and JS files
# プロンプトを送信する。
<br>
==== 計画の確認と編集 ====
計画がチャットパネルに出力される。<br>
<br>
計画の構成を以下に示す。<br>
* 高レベルサマリー
*: タスクの概要と目的
* ステップの分解
*: 実行可能なステップのリスト
* 各ステップの詳細
*: 具体的な実装内容
<br>
計画をマークダウン形式で確認・編集するには、[Open in Editor]を選択する。<br>
<br><br>

== Eclipse / Xcodeでの使用方法 ==
==== Eclipseでの使用方法 ====
# Copilot Chatパネルにサインインする。
# エージェントドロップダウンから[Plan mode]を選択する。
# 高レベルタスクを入力する。
#* 機能追加
#* リファクタリング
#* バグ修正
# [Submit]ボタンを押下する。
<br>
==== Xcodeでの使用方法 ====
# GitHub Copilot for Xcodeを開く。
# サインインする。
# エージェントドロップダウンから[Plan mode]を選択する。
# タスクを入力する。
# [Submit]ボタンを押下する。
<br><br>

== Copilot CLIでの使用方法 ==
==== プランモードの切り替え ====
Copilot CLIでは、キーボードショートカットでプランモードに切り替える。<br>
* [Shift] + [Tab]キー
*: プランモードに切り替える
*: 再度、[Shift] + [Tab]キーを押下するとプランモードが終了する。
<br>
==== ask_userツール ====
プランモードでは、ask_userツールを使用してユーザに質問できる。<br>
<br>
ask_userツールの機能を以下に示す。<br>
* フォローアップ質問
*: 要件の明確化
* 仮定の確認
*: Copilotの解釈が正しいか確認
* 設計判断についてユーザ入力を取得
*: 複数の選択肢から選択
<br>
==== 計画のレビュー ====
専用パネルで計画をレビューし、ユーザが同意後に実装を開始する。<br>
<br>
==== 関連コマンド ====
Copilot CLIでは、以下に示すコマンドが使用できる。<br>
<br>
* <code>/model <モデル名  例: gpt-5.2-codex></code>
*: モデル選択
*: 高度な推論モデルによる詳細分析
* <code>/compact</code>
*: 会話履歴の圧縮
*: トークン使用量の削減
* <code>/context</code>
*: トークン使用量の詳細表示
*: コンテキストウインドウの管理
* [Ctrl] + [T]キー
*: 推論ステップの表示切り替え
*: Copilotの思考過程を確認
<br>

==== 関連機能 ====
Copilot CLIのプランモードでは、以下に示す機能が利用できる。<br>
<br>
* 高度な推論モデル (GPT-5.2-Codex)
*: 詳細な分析と計画立案
* 会話の操舵機能
*: 計画中にリアルタイム調整が可能
* 自動コンテキスト管理
*: 無制限セッション対応
* 自動コンパクション
*: トークン制限の95%に達すると自動圧縮
<br><br>

== 推奨設定 ==
==== 計画の確認を必ず行う ====
Copilotが実行前に計画を確認するよう指示する。<br>
<br>
* 意図とCopilotの解釈が異なる場合がある
*: ユーザの期待とCopilotの理解にギャップがある可能性
* 計画をレビューすることでコストのかかるミスを防げる
*: 実装後の修正よりも計画段階での修正が効率的である。
* 影響範囲を事前に把握できる
*: 想定外の変更を防ぐことができる。
<br>
==== 複数回イテレーションで洗練 ====
計画を複数回のイテレーションで洗練させる。<br>
<br>
* 要件の明確化
*: 曖昧な要件を具体化
* スコープの調整
*: 不要な部分を削除、必要な部分を追加
* 未解決の質問への対応
*: Copilotからの質問に回答
<br>
イテレーション例を以下に示す。<br>
# 初回
#: 高レベルの計画を取得
# 2回目
#: 詳細な実装ステップを追加
# 3回目
#: リスクと代替案を検討
# 4回目
#: 最終確認と承認
<br>
==== 境界を明確に設定 ====
変更範囲の境界を明確に設定する。<br>
<br>
* 境界を与えないとCopilotは範囲外の作業をする可能性がある
*: 例: ボタンの変更を依頼したのに認証システム全体をリファクタリングしようとする。
* スコープクリープを防げる
*: 当初の目的から逸脱しない。
* レビューが容易になる
*: 変更範囲が明確なので確認しやすい。
<br>
境界設定の例を以下に示す。<br>
* ファイルの範囲を指定
*: src/components/Button.tsx のみ変更
* 機能の範囲を指定
*: ボタンのスタイル変更のみ、ロジックは変更しない。
* 影響範囲を制限
*: 既存のAPIは変更しない。
<br>
==== planツールを使用して問題を早期発見 ====
Agent modeで作業する際には、planツールを使用して問題を早期に発見する。<br>
<br>
planツールのメリットを以下に示す。<br>
* 実装前に設計上の問題を発見
*: アーキテクチャの問題を早期に特定
* 依存関係の問題を特定
*: 循環依存などの問題を事前に検出
* リソースの無駄を防ぐ
*: 間違った方向への実装を避ける
<br><br>

== Claude Codeとの比較 ==
GitHub CopilotのプランモードとClaude Codeのプランモードの比較を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ プランモードの比較
! 項目 !! GitHub Copilot !! Claude Code
|-
| 名称 || Plan mode / Planning || Plan mode
|-
| 切り替え方法 || UIでPlanエージェント選択 / [Shift] + [Tab]キー (CLI) || [Shift] + [Tab]キー / --permission-mode plan
|-
| 読み取り専用 || 計画承認までコード変更なし || 完全に読み取り専用
|-
| ユーザへの質問 || ask_userツール || AskUserQuestionツール
|-
| 計画形式 || マークダウン + JSON || 自然言語での計画立案
|-
| 対応環境 || VS Code、Visual Studio、JetBrains、Eclipse、Xcode、CLI || CLI、VS Code拡張
|-
| 設定ファイル || [ツール]メニューバー - [オプション] (Visual Studio) || settings.json
|-
| Todoリスト || 自動生成 || TaskCreate / TaskUpdateツール
|}
</center>
<br>
<center>
{| class="wikitable"
|+ GitHub CopilotとClaude Codeの共通点
! 項目
|-
| 実装前の計画立案を重視
|-
| ユーザへの質問機能
|-
| 読み取り専用の分析フェーズ
|-
| キーボードショートカットでの切り替え
|}
</center>
<br>
<center>
{| class="wikitable"
|+ GitHub CopilotとClaude Codeの相違点
! 項目 !! GitHub Copilot !! Claude Code
|-
| インターフェース || GUI中心 || CLI中心
|-
| 内部プラン形式 || JSON形式 || 自然言語中心
|-
| 対応環境 || 複数のIDE対応 || VS Code拡張とCLI
|}
</center>
<br><br>

== 使用すべきケース ==
GitHub Copilotのプランモードを使用すべきケースを以下に示す。<br>
<br>
* 複雑なリファクタリングの計画
*: 複数のファイルにまたがる大規模なリファクタリング
*: アーキテクチャの変更
* 新機能の設計検討
*: 実装方法の調査
*: 影響範囲の分析
* マルチステップのタスク
*: 複数の段階に分けて実装する必要がある場合
*: 依存関係が複雑な場合
* アーキテクチャ変更
*: システム全体に影響する変更
*: 設計パターンの導入
* 影響範囲の分析が必要な場合
*: 変更が及ぼす影響を事前に把握したい場合
*: リスク評価が必要な場合
<br><br>

== 使用すべきでないケース ==
GitHub Copilotのプランモードを使用すべきでないケースを以下に示す。<br>
<br>
* 単純なバグ修正
*: 1つのファイルの小さな修正
*: 原因と解決方法が明確な場合
* 小規模な変更
*: 数行のコード変更
*: 影響範囲が限定的な場合
* 明確な実装手順が既にある場合
*: 詳細な設計書がある場合
*: 標準的な実装パターンがある場合
<br><br>

== 参考リンク ==
* [https://code.visualstudio.com/docs/copilot/chat/chat-planning VS Code - Planning with Copilot Chat]
* [https://learn.microsoft.com/en-us/visualstudio/ide/copilot-agent-mode?view=visualstudio Visual Studio - GitHub Copilot Agent Mode]
* [https://github.blog/changelog/2025-11-18-plan-mode-in-github-copilot-now-in-public-preview-in-jetbrains-eclipse-and-xcode/ GitHub Changelog - Plan mode in GitHub Copilot (JetBrains、Eclipse、Xcode)]
* [https://github.blog/changelog/2026-01-21-github-copilot-cli-plan-before-you-build-steer-as-you-go/ GitHub Changelog - GitHub Copilot CLI plan mode]
* [https://docs.github.com/en/copilot/tutorials/plan-a-project GitHub Docs - Plan a project with GitHub Copilot]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]