browser-record

ブラウザ記録

ほかのすべてのブラウザスキルが組み合わせる基盤です。名前付きのブラウザーセッションを開き、そのための RVF コンテナを割り当て、すべての操作を ruvector の軌跡ステップに関連付けます。このスキル（またはこれをラップするスキル）を呼び出さずに、このプラグインでブラウザーセッションを実行しないでください。

使用するタイミング

• 使い捨ての一度限りの調査ではない、あらゆるブラウザー操作を開始するとき。
• 後で再生または分析できるよう、トレースを保持しながらサイトを対話的に調べるとき。
• 下流のスキル（browser-extract、browser-form-fill、browser-test）が組み合わせて使う、再利用可能なセッションを確立するとき。

手順

1. セッション ID と RVF コンテナを割り当てます：

   SID="$(date +%Y%m%d-%H%M%S)-${TASK_SLUG:-record}"
   npx -y [email protected] rvf create "$SID.rvf" --dimension 384
   npx -y [email protected] hooks trajectory-begin --session-id "$SID" --task "$1"
   

2. URL を指定して mcp__plugin_ruflo-core_ruflo__browser_open でブラウザーを開きます。
3. 初期状態をスナップショットに記録します：アクセシビリティツリーには browser_snapshot を、基準画像には browser_screenshot を使用します。
4. 各操作について、前後に軌跡ステップを記録します：

   npx -y [email protected] hooks trajectory-step \
     --session-id "$SID" --action click --args '{"selector":"#login"}' --result ok
   

5. 適切に終了します：

   npx -y [email protected] hooks trajectory-end --session-id "$SID" --verdict pass
   npx -y [email protected] rvf compact "$SID.rvf"
   

6. browser-sessions の下で AgentDB にインデックスを作成します：

   npx -y @claude-flow/cli@latest memory store --namespace browser-sessions \
     --key "$SID" --value "{rvf_id:$SID,host:...,task:...,verdict:pass}"
   

注意事項

• browser_session_record MCP ツールが提供されるまでは（ADR-0001 §7）、このスキルは独自の bash ステップ内からライフサイクルを制御します。これらのラッパーを使わずに mcp__plugin_ruflo-core_ruflo__browser_open を直接呼び出さないでください。
• セッション ID の形式は固定です：<YYYYMMDD-HHMMSS>-<task-slug>。下流の /ruflo-browser ls はこれを解析します。
• --with-dom は高コストです（ナビゲーションごとに HTML 全体をダンプします）。デフォルトでは無効です。
• AIDefence のゲートはナビゲーション時ではなく、抽出時に適用されます。browser-record は基盤であり、コンテンツを読み取るスキル（browser-extract、browser-test）がレダクションを担います。