Copilotの“話しすぎ”を止める：VS Code運用でトークンを削る設計原則

VS Code×Copilotで“ムダ話”を切る実務運用――トークン浪費を最小化する設計と手順

日常的にCopilot（Chat/Ask/Agent）を使うほど、やり取りは増えコストは膨らむ。この記事は、生成量を減らしても生産性を落とさないための原則・ワークフロー・ガードレール・VS Code設定の実務知を体系化する。具体的な文言は示さず、行動・観点・手順に絞って解説する。

---

1. 背景と問題設定

• Copilotは文脈を広く“察して”返すため、問いが大きいほど生成が長くなる。長文の往復はそのままコストに直結する。

• Askはスポットでの質問向き、Chatは対話履歴を踏まえた探索向き、Agentは自動実行と外部ツールの連携まで踏み込む。

• 典型的な浪費パターン

  • 依頼が“大きい／曖昧”で、冗長な計画や網羅解を出させる
  • 履歴や@workspaceを広範囲に読ませ、無関係な説明が付く
  • Agentに自由度を与えすぎ、不要な探索・編集・テストを連鎖させる

2. 原則（最小単位で使い倒す）

• 小さく依頼する

  • 目的は一つに限定。関数やテストケースなど“成果物の最小単位”で合意する。
  • 選択範囲を渡し、対象箇所に集中させる。

• 出力上限を明示する

  • 文字数・項目数・ファイル点数の上限をはじめに示す。十分ならそこで止める。

• ログやREADMEの丸投げ禁止

  • 必要行だけを抜粋し、背景は箇条書きの事実に限定。

• 二段階の生成

  • まず要約（意図・差分・観点）で短く合意→詳細化する。

• チームの軽量ガイドを1枚

  • フォーマット（差分/箇条書き/表）、上限（文字・関数数）、レビュー観点（安全性・影響範囲・複雑度）を明記。

3. ワークフロー設計（ムダを生まない進め方）

• 段階分割：設計→実装→テスト

  • 設計では“目的・入力・出力・副作用”だけを短く固める。実装は関数単位、テストは対象関数に限定。

• 作戦会議→実装の二ステップ

  • 最初に成果物の粒度・制約・評価基準を合意し、次のターンで生成する。

• 粒度の基準

  • 関数単位：既存コードの置換・修正
  • モジュール単位：新規ファイルの骨格・I/F整備
  • リポの一部：構成変更や設定の差分
  • いずれも“編集対象ファイル名”と“差分形式”を先に定義。

• インライン補完とChat/Agentの使い分け

  • 既知のパターンや短い実装はインラインで即決。設計判断や複ファイル編集はChat/Agentに限定。

4. Agent運用のガードレール

• 対象範囲の極小化

  • ディレクトリ限定、拡張子限定、ファイル名リスト固定。外部APIやネットワーク呼び出しは既定で不可。

• ドライラン必須

  • 実行前に計画（手順・対象ファイル・想定差分・試験観点）を提示させ、承認後に実行。

• ステップ・時間・外部ツールの制約

  • ステップ数と最大実行時間を設定。テストやフォーマッタ等の利用可否を明記。

• 失敗時の即停止と報告

  • リトライ前に失敗理由・再現条件・代替案を言語化。原因が曖昧なままの連続試行を禁じる。

5. VS Code側の実務Tips

• ワークスペース分割

  • 大規模モノレポは“作業サブセット”を別ワークスペース化し、@workspaceの探索範囲を物理的に縮小。

• 生成物・依存物の除外

  • 検索・参照・インデックス対象からnode_modulesやビルド成果物、キャッシュ、ログを除外。設定はチームで共有。

• インライン補完の長文化を抑える

  • 補完の頻度・最大長・自動受諾の閾値を見直し、“ながら受諾”を減らす。

• “常時吸う”拡張は必要時のみON

  • ログ監視・自動テスト全走破・静的解析の常時実行はオフにし、トリガー実行へ切替。

6. 無駄トークンが膨らむ典型トラップと回避策

• 典型トラップ

  • 巨大ファイル丸投げ、最適解の網羅要求、一発で完璧、履歴を溜めた長対話、Agentの自由探索。

• 回避キット

  • 関心範囲を限定（ファイル名・関数名・差分指定）
  • 段階分割（要約→詳細、設計→実装→テスト）
  • 意思決定の先出し（採用基準・非採用条件・制約）
  • 出力上限の明示（文字・項目・ファイル点数）

7. チーム運用に落とす（軽量ガバナンス）

• 共有ガイド（1枚）の項目

  • 出力上限（短文・項目数）、差分形式（ファイル/関数/パッチ）、レビュー観点（安全性・パフォーマンス・保守性）、貼ってはいけない情報（秘匿鍵・顧客データ）。

• 月次ふりかえり

  • どの機能がトークンを消費しているかを可視化し、ガイドを更新。不要な自動実行は停止。

• セキュリティと秘匿情報

  • 外部送信しない前提で設計。どうしても必要な場合はダミー化・最小化・範囲限定を徹底。

8. まとめ（持続可能な自動化のコツ）

• “速さ”と“安さ”は、粒度管理と合意形成で同時に達成できる。
• まず個人で原則を回し、少人数のチーム規約に昇格させ、やがて組織標準へ。
• ルールは“短く・一貫して・見直す”。使い続けられる仕組みが、最終的にコストを一番下げる。

9. 付録：チェックリスト（配布用1ページ）

• 依頼前

  • 目的は一つか／対象は狭いか／評価基準は明確か
  • 要約→詳細の順になっているか／出力上限は決まっているか

• 実行中

  • 必要な情報だけ渡しているか／十分な時点で停止できているか
  • 差分形式で進めているか／無関係なファイルに触れていないか

• 実行後

  • 生成物は差分レビュー可能か／根拠と判断を記録したか
  • 再利用できる観点（I/F、テスト観点、制約）を残したか