Miyabi tmux マルチエージェント・オーケストレーションとiTerm2プロファイル統合。Agent別カラーテーマ、状態監視、自動プロファイル切り替えを提供。
Install via CLI
openskills install ShunsukeHayashi/Miyabi---
name: tmux × iTerm2 Integration
description: Miyabi tmux マルチエージェント・オーケストレーションとiTerm2プロファイル統合。Agent別カラーテーマ、状態監視、自動プロファイル切り替えを提供。
allowed-tools: Bash, Read, Write, Edit, Grep, Glob
---
# 🎭 tmux × iTerm2 Integration
**Version**: 2.0.0
**Last Updated**: 2025-11-22
**Priority**: ⭐⭐⭐⭐ (P1 Level)
**Purpose**: マルチAgent視覚化とtmux統合によるオーケストレーション
---
## 📋 概要
MiyabiマルチAgentシステムとiTerm2のDynamic Profilesを統合し、
視覚的フィードバックとUI/UX向上を実現します。
---
## 🎯 P0: 呼び出しトリガー
| トリガー | 例 |
|---------|-----|
| セッション作成 | "create tmux session for issue" |
| Agent色分け | "color-coded agent panes" |
| 状態監視 | "monitor agent status" |
| ペイン追加 | "add new agent pane" |
| 配信準備 | "YouTube Live setup" |
---
## 🔧 P1: コマンド一覧
### 基本コマンド(5個)
| コマンド | 用途 | 頻度 |
|---------|------|------|
| `miyabi-start <issue>` | Issue処理開始(5ペイン自動作成) | 高 |
| `miyabi-list` | セッション・ペイン一覧 | 高 |
| `miyabi-assign <pane> <agent>` | プロファイル割り当て | 中 |
| `miyabi-switch <pane> <profile>` | プロファイル切り替え | 低 |
| `miyabi-help` | ヘルプ表示 | 低 |
### 監視コマンド(3個)
| コマンド | 用途 | 頻度 |
|---------|------|------|
| `miyabi-monitor-start <session>` | 状態監視開始(自動切替) | 中 |
| `miyabi-monitor-stop` | 状態監視停止 | 低 |
| `miyabi-monitor <pane> <agent>` | 単一ペイン監視 | 低 |
### ペイン操作(3個)
| コマンド | 用途 | 頻度 |
|---------|------|------|
| `miyabi-add <agent> [v\|h]` | ペイン追加(v=縦, h=横) | 中 |
| `miyabi-add-multi <count> <agent>` | 複数ペイン一括追加 | 低 |
| `miyabi-agents` | 利用可能Agent一覧 | 低 |
---
## 🚀 P2: Agent別プロファイル
### Agent Types(5種)
| Agent | アイコン | 背景色 | ショートカット | 用途 |
|-------|---------|--------|---------------|------|
| **coordinator** | 👑 | 紫 (#1A0F2E) | ⌘7 | 全体統括・タスク割り当て |
| **codegen** | ⚙️ | 緑 (#0F2E1A) | ⌘8 | コード生成・実装 |
| **review** | 🔍 | オレンジ (#2E1F0F) | ⌘9 | コードレビュー・品質 |
| **debug** | 🐛 | 赤 (#2E0F0F) | ⌘0 | デバッグ・エラー解析 |
| **deploy** | 🚀 | 青 (#0F1F2E) | ⌘- | デプロイメント |
### 一般プロファイル(6種)
| プロファイル | ショートカット | 透過度 | フォント | 用途 |
|-------------|---------------|--------|---------|------|
| Miyabi Minimal | ⌘1 | 35% | 18pt | 朝の作業 |
| Miyabi Focus | ⌘2 | 10% | 19pt | 集中作業 |
| Miyabi Vibrant | ⌘3 | 25% | 18pt | 活発な作業 |
| Miyabi Night | ⌘4 | 5% | 18pt | 夜間作業 |
| Miyabi Live | ⌘5 | 0% | 20pt | YouTube配信 |
| Miyabi Designer | ⌘6 | 18% | 19pt | UI/UX設計 |
---
## ⚡ P3: ワークフロー例
### Example 1: Issue処理フル自動化
```bash
# Step 1: ショートカット読み込み
source ~/scripts/miyabi-shortcuts.sh
# Step 2: Issue処理開始
miyabi-start 789
# Step 3: 監視開始
miyabi-monitor-start miyabi-issue-789
# Step 4: セッションアタッチ
tmux attach -t miyabi-issue-789
# レイアウト:
# ┌──────────────┬──────────────┐
# │ 👑 Coord │ ⚙️ CodeGen │
# │ (紫) │ (緑) │
# ├──────────────┼──────────────┤
# │ 🐛 Debug │ 🔍 Review │
# │ (赤) │ (オレンジ) │
# └──────────────┴──────────────┘
```
### Example 2: 既存セッション拡張
```bash
# セッションアタッチ
tmux attach
# CodeGenペイン追加
miyabi-add codegen
# Reviewペイン3つ追加
miyabi-add-multi 3 review
# ペイン%5をDebugモードに
miyabi-assign %5 debug
```
### Example 3: YouTube Live配信
```bash
# 配信モード開始
miyabi-live-start
# → 透過0%、フォント20pt、赤カーソル
# Issue処理デモ
miyabi-start 789
# 配信終了
miyabi-live-end
# → 元のプロファイルに復帰
```
---
## 📊 状態監視システム
### 検出パターン
| 状態 | 検出パターン | プロファイル | 通知 |
|------|-------------|-------------|------|
| **Error** | `error\|failed\|panic` | Debug (赤) | 🐛 エラー |
| **Complete** | `complete\|success\|done` | Vibrant (緑) | ✅ 完了 |
| **Running** | `processing\|building` | Focus | - |
| **Waiting** | `waiting\|pending` | Night | - |
| **Idle** | (その他) | Minimal | - |
### 監視ログ
```
/tmp/miyabi-monitor/
└── pane_<id>.txt # 各ペインのキャプチャログ
```
---
## 🛡️ エラーハンドリング
### プロファイル切り替え失敗
```bash
# iTerm2再起動
killall cfprefsd && \
osascript -e 'quit app "iTerm"' && \
sleep 2 && \
open -a iTerm
```
### セッション見つからない
```bash
# セッション一覧確認
tmux list-sessions
# 新規作成
miyabi-start <issue_number>
```
### ペインID不明
```bash
# 全ペインID表示
miyabi-list
# または
tmux list-panes -a
```
---
## 📁 ファイル配置
### プロファイル設定
```
~/Library/Application Support/iTerm2/DynamicProfiles/
└── MiyabiProfiles.json (11プロファイル)
```
### スクリプト
```
~/scripts/
├── miyabi-tmux-iterm-integration.sh # メインスクリプト
├── miyabi-agent-monitor.sh # 状態監視
├── miyabi-add-pane.sh # ペイン追加
├── miyabi-shortcuts.sh # ショートカット
├── miyabi-profile-switcher.sh # 時間別切替
├── miyabi-live-start.sh # 配信開始
└── miyabi-live-end.sh # 配信終了
```
---
## ✅ 効果測定
| 指標 | 従来 | 現在 | 改善率 |
|------|------|------|--------|
| Agent識別時間 | 5秒 | 1秒 | **80%短縮** |
| エラー発見時間 | 30秒 | 3秒 | **90%短縮** |
| ペイン作成時間 | 2分 | 10秒 | **91%短縮** |
| プロファイル切替 | 手動 | 自動 | **100%自動化** |
---
## 🔗 関連ドキュメント
| ドキュメント | 用途 |
|-------------|------|
| `MIYABI_ITERM2_INTEGRATION_PLAN.md` | 詳細設計書 |
| `MIYABI_QUICK_REFERENCE.md` | クイックリファレンス |
| `context/rust-tool-use-rules.md` | MCP Tool最適化 |
---
## 📝 関連Skills
- **Agent Execution**: Agent実行との連携
- **Rust Development**: ビルド状態の視覚化
- **Debugging**: エラー時の自動プロファイル切替
No comments yet. Be the first to comment!