format について
asciinema v3 の .cast 形式に関するリファレンスを表示するスキルです。ヘッダー項目、イベントコード、解析例、全仕様を確認でき、指定した cast ファイルで例を実行できます。
主な機能
- 01ヘッダー項目の仕様表示
- 02イベントコードの詳細確認
- 03jq と bash の解析例
- 04形式リファレンス全体の表示
- 05cast ファイルを指定した解析例の実行
活用シーン
- 01.cast ファイルのヘッダー項目の確認
- 02イベントコードとその意味の把握
- 03jq または bash による録画データの解析
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill formatインストール後、Claude Code で/formatを入力して読み込まれたか確認します。
同梱ファイルreferences/evolution-log.md
詳細
/asciinema-tools:format
asciinema v3 .cast 形式のリファレンスドキュメントを表示します。
自己進化型スキル:このスキルは使用を通じて改善されます。手順に誤りがある場合、パラメーターにずれが生じた場合、または回避策が必要になった場合は、先送りせず、直ちにこのファイルを修正してください。実際に再現可能な問題がある場合のみ更新してください。
引数
| 引数 | 説明 |
|---|---|
header | ヘッダーフィールドの仕様を表示します |
events | イベントコードの詳細を表示します |
parsing | jq/bash による解析例を表示します |
all | 形式のリファレンス全体を表示します |
-f, --file | 例で使用する特定の .cast を指定します |
--live | ファイルで解析例を実行します |
実行
ユーザーが選択したセクションを指定して asciinema-cast-format スキルを呼び出します。
スキップ条件
- セクションが指定されている場合 -> Phase 1(セクション選択)をスキップします
parsingとともに-fが指定されている場合 -> Phase 2(サンプルファイル)をスキップします
ワークフロー
- 選択:AskUserQuestion でセクションを確認します
- 例:解析の場合は、AskUserQuestion でサンプルファイルを確認します
- 表示:要求されたドキュメントを表示します
例
# Show header format
/asciinema-tools:format header
# Show event codes
/asciinema-tools:format events
# Parse specific file with live examples
/asciinema-tools:format parsing -f session.cast --live
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| ファイルが見つからない | パスが無効です | 絶対パスを使用するか、ファイルが存在することを確認してください |
| 解析エラー | NDJSON が無効です | ファイルが有効な asciinema v3 形式であることを確認してください |
| 出力がない | セクションが指定されていません | header、events、parsing、all のいずれかを指定してください |
実行後の振り返り
このスキルの実行後、終了する前に確認してください。
- コマンドは成功しましたか? — 成功しなかった場合は、失敗の原因となった手順またはエラーテーブルを修正してください。
- パラメーターや出力に変更はありましたか? — 基盤となるツールのインターフェースにずれが生じた場合は、使用例とパラメーターテーブルを実際の内容に合わせて更新してください。
- 回避策が必要でしたか? — 別のフラグや追加手順などで対処した場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。
実際に再現可能な問題がある場合のみ更新してください。憶測による更新は避けてください。
コメント
Markdown 対応