메뉴
Agentの作業を止めずに済む場面でtmuxを活用する。判断軸は「このコマンドの完了を同期的に待つとAgentの作業が止まるか」。止まらない（数秒で終わる確認コマンド）ならBash直接。止まるが管理不要（所要時間が不確実、一度きりの非同期実行）ならtmux直接利用（tmux new-session -d）。止まる上に管理も必要（長時間ビルド・テスト・dev server・watcher・並列検証・対話的CLI・ログ永続化）ならこのスキルを呼び出してジョブ管理する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
tmuxセッション内で実際のNeovimを起動し、send-keys / capture-pane で操作・観察してデバッグする。 Neovimの起動確認、プラグインエラーの調査、checkhealthの確認、設定変更の動作確認、 「nvimをデバッグして」「起動確認して」「checkhealth見て」などのリクエストで使用する。 Agentがnvimを直接実行する必要が生じた場合も、必ずこのスキルの手順を使うこと。
AIとの会話を、ユーザーの思考メモ(Self)も含めてGitHub IssueまたはPull Requestにコメントとして追加する実験版。手動で呼び出して使用。
タスクについて詳細に調査し、構造化されたまとめを出力する。ultrathinkモードで深く考察し、背景、期限、過去の対応方法、確認事項を調査。すべての情報に出典リンクを明記し、推測は必ず明示する。
会話文脈から GitHub issue を作成する。「issueを作って」「issue立てて」等のリクエストで使用。本文は「背景 / やりたいこと / 配慮してほしいこと」の3セクション構成。「背景・やりたいこと」は背景と What(何をやりたいか)に集中し How(実装方法)は書かない。「配慮してほしいこと」は任意(省略可)で制約・要望を書く。
AIとの会話をまとめてGitHub IssueまたはPull Requestにコメントとして追加する。手動で呼び出して使用。
AI Agentの説明で理解できない部分を、前提知識なしで噛み砕いて説明する。会話中にその場で呼び出して使う。用語の定義と、なぜそれが重要かを中心に解説する。
| name | ai-tmux |
| description | Agentの作業を止めずに済む場面でtmuxを活用する。判断軸は「このコマンドの完了を同期的に待つとAgentの作業が止まるか」。止まらない（数秒で終わる確認コマンド）ならBash直接。止まるが管理不要（所要時間が不確実、一度きりの非同期実行）ならtmux直接利用（tmux new-session -d）。止まる上に管理も必要（長時間ビルド・テスト・dev server・watcher・並列検証・対話的CLI・ログ永続化）ならこのスキルを呼び出してジョブ管理する。 |
| argument-hint | [start|list|show|attach|stop|close] ... |
| allowed-tools | Bash |
| disable-model-invocation | false |
AI Agent用のtmuxジョブ管理スキルです。 人間が常用するCLIではなく、Agentが長時間・継続・並列タスクを外部状態として保持するために使います。
コマンドを実行する前に、以下の基準で実行方法を選択する。
ai-tmuxのジョブ管理が不要な場合は、tmuxを直接使う。
tmux new-session -d -s tmp-task -c "$PWD" 'bash -lc "command > /tmp/result.txt 2>&1"'
until ! tmux has-session -t tmp-task 2>/dev/null || [ -s /tmp/result.txt ]; do sleep 3; done
tmux capture-pane -t tmp-task -p -S -30
tmux kill-session -t tmp-task 2>/dev/null
通常のシェル実行は、長時間タスクでは会話の待ち時間、コンテキスト消費、途中入力、ログ喪失が問題になりやすいです。 tmuxに預けると、タスクを外部状態として保持し、Agentは必要なタイミングだけ状態確認やログ回収ができます。 これにより、Agentが実行完了を同期的に待ち続けずに済み、中断に強くなり、sudo待ちや失敗箇所を後から確認しやすくなります。 ただし、tmux自体がトークン消費を減らすわけではありません。頻繁な監視や大きなログ回収は、通常実行よりもトークン消費を増やすことがあります。
実行時間を分析したい場合は、tmuxに預けるコマンド自体を /usr/bin/time -p で包みます。
scripts/ai-tmux.sh start apply-nix -- /usr/bin/time -p make apply-nix
スクリプトパス:
scripts/ai-tmux.sh
基本形:
scripts/ai-tmux.sh start <name> -- <command...>
scripts/ai-tmux.sh list
scripts/ai-tmux.sh show <name>
scripts/ai-tmux.sh attach <name>
scripts/ai-tmux.sh stop <name>
scripts/ai-tmux.sh close <name>
scripts/ai-tmux.sh start test -- bash -lc 'cargo test'
ジョブ名は A-Za-z0-9_.- のみ使用します。
tmux session名は ai-<name> になります。
scripts/ai-tmux.sh list
監視は原則30-60秒間隔にします。
通常確認は list を優先し、ログ取得は状態変化、失敗、sudo待ち、長時間無出力の確認時だけ行います。
これは、tmux監視による追加のトークン消費を増やしすぎないためです。
scripts/ai-tmux.sh show test
直近行数を指定する場合:
scripts/ai-tmux.sh show test -n 40
大量ログが予想される場合は show を繰り返さず、ログファイルに対して rg で重要語だけ確認します。
必要な行だけを抽出し、ユーザーには要点を短く報告します。
rg 'error|failed|sudo|finished_at|exit_code' "${XDG_STATE_HOME:-$HOME/.local/state}/ai-tmux/logs/test.log"
scripts/ai-tmux.sh attach test
scripts/ai-tmux.sh close test
close はtmux sessionだけを閉じ、ログとメタ情報は残します。
start は失敗します。close してください。stop は実行中paneに C-c を送ります。session自体は残します。${XDG_STATE_HOME:-$HOME/.local/state}/ai-tmux/logs/ に保存されます。ps で進行状況を見る場合は全件出力を避け、対象プロセス名に絞ってください。