PJR-4FP2 VS Code からオーケストレーターを使う手順を案内する
1. 概要
Copilot Chat の agent の選択、Claude Code の拡張での既定の agent の設定、Codex の拡張での使い方を、orchestrator-operation-guide・クイックスタート・templates/copilot/README.md に書き、onboarding の間口を広げる
- 利用者が、このリポジトリの VS Code の Copilot Chat の agent の選択肢に
specdojo-orchestratorが出ることを確かめた（2026-10-28）。定義の配布はspecdojo config scaffold --provider copilotが.github/agents/specdojo-orchestrator.mdへ置くことで済んでおり、足りないのは VS Code から使う案内である。 - Claude Code は settings の
agentキーで、セッションを名前付きの agent として開始できる。公式の settings の説明では、ターミナル・VS Code の拡張・JetBrains の拡張・デスクトップのアプリが同じ settings のファイルを読む。
2. 完了条件
- orchestrator-operation-guide に「VS Code から使う」節があり、次の 3 つの拡張の使い方を書く。
- Copilot Chat:
config scaffold --provider copilotの後、チャットの agent の選択肢からspecdojo-orchestratorを選ぶ。 - Claude Code の拡張: settings の
agentキーにspecdojo-orchestratorを設定すると、セッションがオーケストレーターとして始まる。共有の.claude/settings.jsonに書くとそのリポジトリのすべての人のすべてのセッションが対象になるため、各自の.claude/settings.local.jsonに書くことを勧める。 - Codex の拡張: SSOT の本文を最初の指示として渡す。
- Copilot Chat:
- Claude Code の
agentキーと Codex の拡張の使い方は、executor が公式の文書で確かめ、確かめた URL を本個票の対応結果に書く。確かめられなかったことは「未確認」と明記する。 - exec の executor・reporter は起動のコマンドで
--agentを明示しており、settings のagentキーの影響を受けないことを、コマンドの定義（exec-defaults.yamlのcommand_template）で確かめて対応結果に書く。影響を受ける経路が見つかった場合は、その経路と対処の案を対応結果と報告のhandoffに書く（保護された設定は変えない）。 - クイックスタートでオーケストレーターを紹介している箇所に、VS Code から使えることと上の節への参照を足す。
templates/copilot/README.mdの導入手順に、VS Code の Copilot Chat で選ぶ手順を足す。npm run lint:mdとnpm run docs:buildが通り、親の検証 7 件が通る。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | orchestrator-operation-guide に VS Code の節を足す | executor | done | 2.2 節を追加（Copilot・Claude Code・Codex） |
| 2 | Claude Code と Codex の拡張の使い方を公式で確かめる | executor | done | 公式ドキュメントの記述を確認し対応結果に記録 |
| 3 | クイックスタートと Copilot の README に案内を足す | executor | done | quick-start-guide と templates/copilot に反映 |
4. 対応結果
4.1. 公式ドキュメントの確認結果
- Claude Code の
agentキー:- 確認元 URL: https://docs.anthropic.com/en/docs/claude-code/settings
- 公式設定リファレンスにて、
settings.jsonのagentキーが「Start every session as a named subagent with a designated prompt, toolset, and model configuration」として提供されていることを確認した。 - 設定スコープは User（
~/.claude/settings.json）、Shared Project（.claude/settings.json）、Local Project（.claude/settings.local.json）の順で優先される。共有の.claude/settings.jsonに設定するとリポジトリ全員の全セッションが対象になるため、各自の.claude/settings.local.jsonに設定することを推奨する。VS Code 拡張やターミナルで同一の設定が読み込まれる。
- Codex の VS Code 拡張:
- 確認元 URL: VS Code Marketplace https://marketplace.visualstudio.com/items?itemName=openai.chatgpt
- Codex の VS Code 拡張（
Codex – OpenAI's coding agent）において、名前付きカスタムエージェント定義（.codex/agents/*.toml）をドロップダウン等から選択して起動する設定・機能は現時点で公式文書上に記載がなく「未確認」。そのため、会話開始時に SSOT である.agents/specdojo-orchestrator.agent.mdの本文をチャットの最初の指示（プロンプト）として渡す運用を案内する。
4.2. exec defaults における agent キーの影響確認
.specdojo/exec-defaults.yamlのproviders.claude.command_templateを確認した。- テンプレート定義:
claude -p --verbose --agent {agent} --model {model} --settings .specdojo/claude/settings.{mode}.json - 各 mode に応じて
--agent引数（edit:claude-executor、review:claude-review-executor、report:claude-reporter）をコマンドライン引数で明示的に渡している。 - CLI の
--agent引数はsettings.jsonのagentキーの既定値を上書きするため、settings にagentキーが設定されていても exec の executor・reporter 実行には影響しないことを確認した。 - さらに
--settings .specdojo/claude/settings.{mode}.jsonでモード別設定も明示されている。影響を受ける経路はない。
- テンプレート定義:
4.3. 成果物の更新内容
docs/ja/specdojo/guides/orchestrator-operation-guide.md:- 「2.2. VS Code から使う」節を追加し、Copilot Chat、Claude Code 拡張、Codex 拡張の利用手順を記載した。
- 冒頭の「この文書で分かること」に「VS Code からの使い方」を追加した。
docs/ja/specdojo/guides/quick-start-guide.md:- 冒頭のオーケストレーター紹介箇所に、ターミナルだけでなく VS Code の拡張機能（Copilot Chat、Claude Code、Codex）からも利用できる旨と、オーケストレーター運用ガイドの「VS Code から使う」節への参照リンクを追加した。
templates/copilot/README.md:- 導入手順のステップ 5 に、VS Code の Copilot Chat から
specdojo-orchestratorを選んで対話を開始する手順を追加した。
- 導入手順のステップ 5 に、VS Code の Copilot Chat から