feat: WSLのSSH認証情報をDevContainerにマウントする手順を追加

Author: GitHub Copilot CLI

.devcontainer/devcontainer.json

@@ -68,7 +68,11 @@
     "welcome": "echo '🚀 OpenCode ECC DevContainer へようこそ！' && echo '' && echo '📋 次のステップ:' && echo '  1️⃣ .env.template を .env にコピー' && echo '  2️⃣ 必要に応じて ./.devcontainer/interactive-setup.sh でTailscale設定' && echo '' && echo '🎨 サービスURL:' && echo '  📍 OpenChamber: http://localhost:3000' && echo '  🤖 OpenCode CLI: http://localhost:4095'"
   },
   "remoteUser": "vscode",
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/home/vscode/.ssh/agent.sock"
+  },
   "mounts": [
+    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,readonly",
     "source=opencode-data,target=/home/vscode/.opencode,type=volume",
     "source=tailscale-state,target=/var/lib/tailscale,type=volume"
   ]

README.md

@@ -39,6 +39,57 @@ cp .env.template .env
 
 VS Code で `Dev Containers: Reopen in Container` を実行します。
 
+### 3.1 WSLのSSH認証情報を使う（Git SSH用）
+
+このリポジトリの DevContainer は、WSL 側の `~/.ssh` と `SSH_AUTH_SOCK` をコンテナへマウントします。
+
+WSL 側で以下を確認してから `Rebuild and Reopen in Container` を実行してください。
+
+```bash
+# WSL 側で実行
+# 固定ソケットでssh-agentを起動（DevContainer連携用）
+if [ -d ~/.ssh/agent.sock ]; then rm -rf ~/.ssh/agent.sock; else rm -f ~/.ssh/agent.sock; fi
+eval "$(ssh-agent -a ~/.ssh/agent.sock -s)"
+export SSH_AUTH_SOCK=~/.ssh/agent.sock
+
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/<your_key>
+chmod 644 ~/.ssh/<your_key>.pub
+ssh-add ~/.ssh/<your_key>
+
+echo "$SSH_AUTH_SOCK"
+ssh-add -l
+```
+
+- `ssh-agent` を単体実行するだけでは現在のシェルに反映されないため、`eval "$(ssh-agent -a ~/.ssh/agent.sock -s)"` を使ってください。
+- `ssh-add` は公開鍵 (`.pub`) ではなく秘密鍵ファイルを指定してください。
+- `ssh-add -l` で鍵が出ない場合は、`chmod 700 ~/.ssh && chmod 600 ~/.ssh/<your_key>` の後に `ssh-add ~/.ssh/<your_key>` を実行してください。
+
+起動後、DevContainer 内で次を確認できます。
+
+```bash
+echo "$SSH_AUTH_SOCK"
+ls -l /home/vscode/.ssh/agent.sock
+ssh-add -l
+ssh -T git@github.com
+```
+
+`echo "$SSH_AUTH_SOCK"` が空の場合は、次を確認してください。
+
+```bash
+# WSL 側
+if [ -d ~/.ssh/agent.sock ]; then rm -rf ~/.ssh/agent.sock; else rm -f ~/.ssh/agent.sock; fi
+eval "$(ssh-agent -a ~/.ssh/agent.sock -s)"
+export SSH_AUTH_SOCK=~/.ssh/agent.sock
+ssh-add ~/.ssh/<your_key>
+echo "$SSH_AUTH_SOCK"
+
+# 同じ WSL シェルから VS Code を起動
+code .
+```
+
+その後、`Dev Containers: Rebuild and Reopen in Container` を実行してください。
+
 ### 4. 任意: 対話セットアップ
 
 ```bash

docs/QUICK_START.md

@@ -13,22 +13,45 @@ git clone https://github.com/<your-account>/opencode-ecc-devcontainer.git
 cd opencode-ecc-devcontainer
 ```
 
-2. `.env` を作成
+1. `.env` を作成
 
 ```bash
 cp .env.template .env
 ```
 
-3. 必要なら Tailscale 情報を設定
+1. 必要なら Tailscale 情報を設定
 
 - `TAILSCALE_AUTH_KEY`
 - `TAILSCALE_HOSTNAME`
 
-4. DevContainer を起動
+1. DevContainer を起動
 
 - VS Code: `Dev Containers: Reopen in Container`
 
-5. 任意で対話セットアップ
+1. （WSL利用時）SSH認証情報の確認
+
+DevContainer は WSL の `~/.ssh` と `SSH_AUTH_SOCK` を利用できます。
+WSL 側で次を確認してください。
+
+```bash
+if [ -d ~/.ssh/agent.sock ]; then rm -rf ~/.ssh/agent.sock; else rm -f ~/.ssh/agent.sock; fi
+eval "$(ssh-agent -a ~/.ssh/agent.sock -s)"
+export SSH_AUTH_SOCK=~/.ssh/agent.sock
+
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/<your_key>
+chmod 644 ~/.ssh/<your_key>.pub
+ssh-add ~/.ssh/<your_key>
+
+echo "$SSH_AUTH_SOCK"
+ls -l /home/vscode/.ssh/agent.sock
+ssh-add -l
+```
+
+`ssh-agent` を単体実行するだけでは現在のシェルに反映されないため、`eval "$(ssh-agent -a ~/.ssh/agent.sock -s)"` を使ってください。
+`ssh-add` は公開鍵 (`.pub`) ではなく秘密鍵ファイルを指定してください。
+
+1. 任意で対話セットアップ
 
 ```bash
 ./.devcontainer/interactive-setup.sh