Max Nardit
AI エージェント

Share2Agent で Web ページを GitHub Copilot に送る方法

ドキュメント、チュートリアル、エラーページを GitHub Copilot Chat のコンテキストに直接送ります。Share2Agent はあらゆる Web ページからクリーンなテキストを抽出し、ワークスペース内に Markdown として保存します。Copilot は @workspace 経由でそれを参照できます。

前提条件

  • VS Code に GitHub Copilot 拡張機能がインストール済み (Copilot Chat 有効)
  • Share2Agent Chrome 拡張機能がインストール済み
  • Python 3.10+ と PyYAML (pip install pyyaml)

ステップ 1: レシーバーをセットアップする

レシーバーは共有されたページを Markdown ファイルとして保存します。Copilot はワークスペースからそれを読み取ります。

bash
git clone https://github.com/mnardit/share2agent.git
cd share2agent/examples/receiver
pip install pyyaml

ステップ 2: ページをワークスペースに保存する

レシーバーが VS Code ワークスペース内のディレクトリに書き込むようにします。

bash
export PAGES_DIR=~/my-project/shared-pages
python3 -u receiver.py

レシーバーはポート 9876 で待ち受けます。共有された各ページは、YAML フロントマター (URL、タイトル、メタデータ) と抽出された全テキストを含む .md ファイルとして保存されます。

ステップ 3: Share2Agent を設定する

  1. Chrome で Share2Agent 拡張機能のアイコンをクリックします。
  2. Settings を開きます。
  3. Webhook URL を http://localhost:9876 に設定します。
  4. 保存します。

ステップ 4: ページを共有する

  1. ドキュメントページ、GitHub Issue、または必要なリファレンスを開きます。
  2. Share2Agent のアイコンをクリックします。
  3. なぜそのページが重要なのかを説明する コメント を任意で書きます (例: 「我々の API の認証例」)。
  4. Share をクリックします。

ページがワークスペースに保存されます。

~/my-project/shared-pages/2026-03-28-1430-github-api-authentication.md

ステップ 5: Copilot Chat で使う

GitHub Copilot Chat は @workspace をサポートしており、プロジェクト全体からコンテキストを検索します。保存された Markdown ファイルがワークスペース内にあるため、Copilot は自動的にインデックスを作成します。

VS Code で Copilot Chat を開いて質問します。

@workspace 保存した GitHub API の認証ドキュメントに基づいて、
我々の auth モジュールでトークンの更新をどう実装すべきか教えてください。

Copilot は関連する .md ファイルを見つけて、回答のコンテキストとして使います。

ファイルを直接参照することもできます。

#file:shared-pages/2026-03-28-1430-github-api-authentication.md
ここで説明されているレートリミット戦略を解説してください。

ヒント

  • ディレクトリを .gitignore に: 共有されたページは一時的な参照素材であり、ソースコードではありません。shared-pages/ を .gitignore に追加します。
  • コメントを指示として使う: Share2Agent で書いたコメントは Markdown のフロントマターに保存されます。「現在のアプローチと比較する」のようなコンテキストを書いておけば、なぜ保存したのかを思い出せます。
  • ターミナルでの Copilot: VS Code の統合ターミナルで Copilot を使う場合 (Ctrl+I)、ファイルパスを直接貼り付けて、Copilot に説明や要約を依頼できます。

バックグラウンドサービスとして実行する

bash
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/share2agent-receiver.service << 'EOF'
[Unit]
Description=Share2Agent Webhook Receiver
 
[Service]
Environment=PAGES_DIR=%h/my-project/shared-pages
ExecStart=/usr/bin/python3 -u /path/to/receiver.py
Restart=on-failure
 
[Install]
WantedBy=default.target
EOF
 
systemctl --user daemon-reload
systemctl --user enable --now share2agent-receiver

次のステップ

  • 保存時に自動要約: receiver.py を拡張して LLM を呼び出し、各保存ファイルの先頭に要約を追加すれば、Copilot がポイントをすぐに把握できます。
  • トピックごとに整理: コメントフィールドを使ってページをサブディレクトリに振り分けます (例: shared-pages/auth/、shared-pages/testing/)。
  • Copilot Edits と組み合わせる: 参照ページを共有した後、Copilot Edits で文書化されたパターンに基づきコードをリファクタリングします。
Share2Agent で Web ページを GitHub Copilot に送る