mcpField
C
convert

convert

github.com/terrylicaドキュメント192 回インストール今日更新
リポジトリ

convert について

asciinema の .cast 録画を整形された .txt ファイルに変換するスキルです。単一ファイルと一括処理に対応し、変換オプションや出力先の選択、統計の確認を支援します。

主な機能

  1. 01単一ファイルの変換
  2. 02ディレクトリ単位の一括変換
  3. 03タイムスタンプ索引と停止区間での分割
  4. 04ターミナル寸法の保持
  5. 05圧縮率と一括処理の統計

活用シーン

  1. 01単一のターミナル録画をテキスト化
  2. 02録画ファイルのディレクトリを一括処理
  3. 03長いアイドル区間で録画を分割
  4. 04指定した出力先への変換ファイルの整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill convert

インストール後、Claude Code で/convertを入力して読み込まれたか確認します。

同梱ファイルreferences/evolution-log.md

詳細

/asciinema-tools:convert

asciinema の .cast 録画を、整形された .txt ファイルに変換します。単一ファイルモードとディレクトリ一括モードに対応しています。

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

引数

単一ファイルモード
引数説明
file.cast ファイルへのパス
-o, --output出力先のパス（デフォルト：同じディレクトリ）
--indexタイムスタンプ付きインデックス版を作成
--chunks30 秒以上のアイドル状態の間隔で分割
--dimsターミナルのサイズを保持
--analyze変換後に /analyze を自動実行
一括モード
引数説明
--batchディレクトリ変換の一括モードを有効にする
--sourceソースディレクトリ（デフォルト：~/asciinemalogs）
--output-dir出力ディレクトリ（デフォルト：~/Downloads/cast-txt/）
--skip-existing.txt 出力がすでにあるファイルをスキップする（デフォルト：true）

注：--batch と位置引数の file は同時に指定できません。

実行

ユーザーが選択したオプションで asciinema-converter スキルを呼び出します。

単一ファイルのスキップ条件
  • file が指定されている場合 → フェーズ 1（ファイル選択）をスキップ
  • オプションが指定されている場合 → フェーズ 2（オプション）をスキップ
  • -o が指定されている場合 → フェーズ 3（出力先）をスキップ
  • --analyze が指定されている場合 → フェーズ 6 をスキップして analyze を自動実行
一括モードのスキップ条件
  • --batch が指定されている場合 → フェーズ 1～3 をスキップし、一括モードのフェーズ（7～10）に進む
  • --source が指定されている場合 → フェーズ 7（ソース選択）をスキップ
  • --output-dir が指定されている場合 → フェーズ 8（出力の整理）をスキップ
単一ファイルのワークフロー
  1. 事前確認：asciinema convert コマンドを確認
  2. 検出：.cast ファイルを検索
  3. 選択：ファイルを AskUserQuestion で尋ねる
  4. オプション：変換オプションを AskUserQuestion で尋ねる
  5. 場所：出力先を AskUserQuestion で尋ねる
  6. 実行：asciinema convert を実行
  7. 報告：圧縮率を表示
  8. 次の操作：次に行う操作を AskUserQuestion で尋ねる
一括ワークフロー
  1. 事前確認：asciinema convert コマンドを確認
  2. ソース：ソースディレクトリを AskUserQuestion で尋ねる
  3. 出力：出力ディレクトリを AskUserQuestion で尋ねる
  4. 実行：進捗を報告しながら一括変換
  5. 報告：圧縮統計の集計結果を表示
  6. 次の操作：次に行う操作を AskUserQuestion で尋ねる

例

# Single file conversion
/asciinema-tools:convert ~/Downloads/session.cast

# Batch mode with defaults
/asciinema-tools:convert --batch

# Batch mode with custom paths
/asciinema-tools:convert --batch --source ~/Downloads --output-dir ~/cast-txt/

# Batch mode, force re-convert existing
/asciinema-tools:convert --batch --skip-existing=false

トラブルシューティング

問題原因解決策
asciinema が見つからないasciinema がインストールされていないbrew install asciinema
変換コマンドが失敗する.cast ファイルが破損している最初に asciinema cat file.cast を試す
.cast ファイルが見つからないディレクトリが間違っている--source のパスを確認する
出力が作成されない書き込み権限がない出力先の書き込み権限を確認する
ファイルが大きすぎる録画時間が長い--chunks を使って一時停止箇所で分割する

実行後の振り返り

このスキルの完了後、終了する前に次の点を確認してください。

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

推測ではなく、実際に再現可能な問題がある場合のみ更新してください。

コメント

Markdown 対応