菜单
呼び出し側から渡された nvim の socket パスを使い、socket 経由 (nvim --server --remote-tab / --remote-send) でファイル・diff・コマンド出力を nvim へ流し込む具体手順。nvim でファイルを開く / diff を見せる / 長文出力を見せる際に使用する。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | nvim-remote |
| description | 呼び出し側から渡された nvim の socket パスを使い、socket 経由 (nvim --server --remote-tab / --remote-send) でファイル・diff・コマンド出力を nvim へ流し込む具体手順。nvim でファイルを開く / diff を見せる / 長文出力を見せる際に使用する。 |
呼び出し側から渡された socket パス経由で nvim を遠隔操作し、作業結果を nvim に流し込む。socket パスがどう供給されるか (環境変数・呼び出し時の指示等) は呼び出し側の責務であり、この skill はそれに関与しない。
この skill は socket パスが与えられている前提で動く。socket の検出・導出・存在チェックは呼び出し側が済ませている。
次の手順では、渡された socket パスを $sock に入れて使う。
sock="<呼び出し側から渡された socket パス>"
socket パスが渡されていない場合、この skill は適用できない。nvim 手順 (--server 系のコマンド) を一切実行せず、socket パスが渡されていないため nvim へ流せなかったことを呼び出し元へ伝えて終える。伝える際、流すはずだった内容 (ペイロード) を応答に同梱してよい (呼び出し側が代替手段を選ぶ際に再入手が不要になる)。コンソール出力等の代替手段を取るかどうかは呼び出し側の判断であり、この skill 側で勝手に代替しない。断るのは nvim 手順だけで、ユーザの本来の目的をどう満たすかは呼び出し側に委ねる。
nvim --server "$sock" --remote-tab <filepath>
先にどちらの手順かを選ぶ。2 つのファイルパスが具体的にある (「A と B を並べて」等) なら「2 ファイル間の diff」、git diff 等のコマンドが吐く差分文字列を見せるなら「差分文字列そのものを見せる」。
基準ファイル (base、例: リファクタ前・変更前) を --remote-tab で新規タブに開き、続けて比較ファイル (compare、例: リファクタ後・変更後) を vert diffsplit で左右に重ねる。<Esc> を前置して insert mode の影響を避ける。
--remote-tab で開く側。compare = 後から diffsplit で重ねる側。どちらが base かは statusline のファイル名で判別する。diffsplit には vert を付けて左右に並べる (:vert diffsplit)。この vert は意図した指定なので外さない。外すと上下分割になり「並べる」意図とずれる。splitright が決めるのは compare が左右どちらの側に入るかだけで、vert を付けるかどうかとは別の話。左右の位置を前提にした説明 (どちらが左か等) は書かない。base="$(realpath <旧・基準ファイル>)"
compare="$(realpath <新・比較ファイル>)"
nvim --server "$sock" --remote-tab "$base"
nvim --server "$sock" --remote-send '<Esc>:vert diffsplit '"$compare"'<CR>'
git diff 等の差分文字列は一時ファイルに書き出してから開く。拡張子 .diff で filetype が自動判定される。
tmp=$(mktemp --suffix=.diff)
git diff > "$tmp"
nvim --server "$sock" --remote-tab "$tmp"
git diff は例示であり、差分の生成コマンドは依頼内容 (対象リポジトリ・リビジョン範囲) に合わせて置き換える。cwd が対象リポジトリと一致しない環境では git -C <repo> diff ... の形にする。
コマンド実行結果や調査結果等、長文の出力は一時ファイルに書き出して --remote-tab で開く。
.md/.log/.json/.txt 等)。filetype 判定が効く。tmp=$(mktemp --suffix=.md)
<command> > "$tmp" # コマンド出力を流す場合
# 文字列が手元にある場合: printf '%s\n' "$var" > "$tmp" (echo ではなく printf。-e 解釈や先頭ハイフン事故を避ける)
nvim --server "$sock" --remote-tab "$tmp"
--remote ではなく --remote-tab を使用する。ユーザが編集中のバッファを上書きしない為、必ず新規タブに開く。--remote-tab/diffsplit のパス解決基準は受け取る nvim 側の cwd であり、エージェント側の cwd と一致する保証がない。相対パスで来たら realpath <path> 等で絶対パスへ解決してから渡す (mktemp が返すパスは元から絶対なのでそのままでよい)。--remote-send で送るキーシーケンスは nvim 記法 (<Esc>/<CR> 等) を使用する。<Esc> を前置する。ライブラリ・フレームワーク・SDK・API・CLI ツール・クラウドサービス (React, Next.js, Prisma, Express, Tailwind, Django, Spring Boot 等の著名なものを含む) について質問された際に、Context7 CLI で最新の公式ドキュメントを取得してから回答する。 API 構文・設定方法・バージョン移行・ライブラリ固有のデバッグ・セットアップ手順・CLI ツールの使用方法が対象。ライブラリのドキュメントに関しては Web 検索よりこちらを優先する。 リファクタリング・ゼロからのスクリプト作成・ビジネスロジックのデバッグ・コードレビュー・一般的なプログラミング概念の質問には使わない。
メインの worktree (clone 直下) のブランチを切り替えず、別ブランチの作業を隔離 worktree で行う手順。ファイルを変更する作業で専用ブランチを切るとき、または main から切られた別ブランチを調べるときに git worktree でチェックアウトし branch description を付ける。現在のブランチに対する読み取りだけの調査には使わない。