pty-capture について
端末がキー入力に対して出力する正確なバイト列を記録するスキルです。画面表示ではなく入力エンコーディングの確認を目的とし、Linux、Windows、macOS の手順と CLI 互換性テストへの利用を説明します。
主な機能
- 01キー入力に対する出力バイトの記録
- 02Linux、Windows、macOS に対応
- 03プラットフォーム別の記録手順
- 04記録データをリプレイテストに利用
活用シーン
- 01端末が送るキーシーケンスの検証
- 02端末互換性テスト用フィクスチャの作成
- 03CLI のキー処理のデバッグ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ factory-ai/ factory-plugins --skill pty-captureインストール後、Claude Code で/pty-captureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
platforms/linux.mdmacos.mdwindows.md詳細
PTY バイトキャプチャ
オーケストレーターによってここに案内されました。以下の手順を使って計画を実行してください。
指定したキー入力に対して、実際のターミナルが出力するバイト列を正確にキャプチャします。「UI の表示は正しいか」ではなく、「ターミナル X はキー Y に対してどのシーケンスを送信するか」を確認する場合に使ってください。
プラットフォームのサポート
| プラットフォーム | 状態 | 参照先 |
|---|---|---|
| Linux / Wayland | 実装済み | platforms/linux.md |
| Windows(KVM) | 実装済み | platforms/windows.md |
| macOS(QEMU) | 実装済み | platforms/macos.md |
対象 OS のプラットフォームファイルを読んでください。 各ファイルには、キャプチャのアーキテクチャ、前提条件、使用方法、プラットフォーム固有の注意事項が記載されています。
既知の行き止まり
- Xvfb + xdotool:実際のキーボード処理を完全に迂回します
- uinput + Xvfb:Xvfb はカーネルの入力デバイスを認識しません
- キー入力の注入に SSH PTY を使う方法:入力エンコーディングが変化します。SSH は出力のキャプチャまたはデプロイのみに使用してください
次の手順
キャプチャしたバイト列をターミナル互換性フィクスチャに渡し、apps/cli でリプレイテストを実行します。
コメント
Markdown 対応