record

/asciinema-tools:record

asciinema でターミナルの録画セッションを開始します。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある場合、パラメーターにずれが生じた場合、または回避策が必要になった場合は、先送りせず、このファイルをすぐに修正してください。実際に再現できる問題がある場合にのみ更新してください。

引数

引数	説明
file	出力パス（例：session.cast）
-t, --title	録画タイトル
-i, --idle-time-limit	最大アイドル時間（秒）
--backup	GitHub へのストリーミングバックアップを有効にします
--append	既存の録画に追記します

実行

ユーザーが選択したオプションを使って、asciinema-recorder スキルを呼び出します。

スキップ条件

• file が指定されている場合 -> フェーズ 1（出力先）をスキップします
• -t と -i が指定されている場合 -> フェーズ 2（オプション）をスキップします

ワークフロー

1. 事前確認：asciinema がインストールされているか確認します
2. 場所：AskUserQuestion で出力パスを尋ねます
3. オプション：AskUserQuestion で録画オプションを尋ねます
4. 生成：録画コマンドを組み立てて表示します
5. 案内：手順を順番に示します

例

# Basic recording
/asciinema-tools:record session.cast

# Recording with title and idle limit
/asciinema-tools:record -t "Demo Session" -i 30

# Recording with GitHub backup
/asciinema-tools:record session.cast --backup

トラブルシューティング

問題	原因	解決策
asciinema が見つからない	未インストール	brew install asciinema
アクセスが拒否された	出力パスの問題	出力ディレクトリへの書き込み権限を確認してください
録画が開始されない	ターミナルの問題	対話型ターミナルで実行していることを確認してください

実行後の振り返り

このスキルの実行後、終了する前に確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラーテーブルを修正してください。
2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースにずれが生じていた場合は、Usage の例と Parameters テーブルを実際の内容に合わせて更新してください。
3. 回避策が必要でしたか？ — 別のフラグや追加手順などで対応した場合は、次回の実行で同じ回避策が必要にならないよう、この SKILL.md を更新してください。

実際に再現できる問題がある場合にのみ更新してください。推測に基づく更新は行わないでください。