full-workflow について
録画、ストリーミングバックアップ、変換、分析を連携させる asciinema の一連のワークフロースキルです。引数でバックアップや分析を省略し、簡易または詳細分析を選べます。
主な機能
- 01録画、バックアップ、変換、分析の連携
- 02タイトルと分析対象ドメインの指定
- 03バックアップまたは分析の省略
- 04簡易分析と詳細分析の選択
- 05完了サマリーの表示
活用シーン
- 01ターミナルセッションの録画と分析
- 02録画と変換だけを行い、分析は後回し
- 03分析用のタイトルやドメインの指定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill full-workflowインストール後、Claude Code で/full-workflowを入力して読み込まれたか確認します。
同梱ファイルreferences/evolution-log.md
詳細
/asciinema-tools:full-workflow
エンドツーエンドのワークフロー全体を実行します:録画、バックアップ、変換、分析。
自己進化型スキル:このスキルは使用するたびに改善されます。指示に誤りがある場合、パラメーターが変わった場合、または回避策が必要になった場合は、後回しにせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合にのみ更新してください。
引数
| 引数 | 説明 |
|---|---|
-t, --title | 録画のタイトル |
-q, --quick | 録画後に簡易分析 |
-f, --full | 録画後に詳細分析 |
-d, --domains | 分析対象のドメイン |
--no-backup | ストリーミングバックアップをスキップ |
--no-analyze | 分析をスキップ(録画と変換のみ) |
実行
複数のスキルを連結します:録画 -> バックアップ -> 変換 -> 分析
スキップの条件
-tが指定された場合 -> タイトルをそのまま使用します-qまたは-fが指定された場合 -> ワークフローの設定をスキップします--no-backupが指定された場合 -> バックアップ手順をスキップします--no-analyzeが指定された場合 -> 分析手順をスキップします
ワークフロー
- 設定:ワークフローのオプションを AskUserQuestion で尋ねます
- 録画:asciinema-recorder を呼び出します
- バックアップ:有効な場合、asciinema-streaming-backup を呼び出します
- 変換:asciinema-converter を呼び出します
- 分析:有効な場合、asciinema-analyzer を呼び出します
- レポート:概要を表示します
使用例
# Quick workflow with title
/asciinema-tools:full-workflow -t "Feature dev" -q
# Full analysis on trading domain
/asciinema-tools:full-workflow -f -d trading,ml
# Record only, analyze later
/asciinema-tools:full-workflow --no-analyze
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| 録画が見つからない | asciinema のアクティブなセッションがない | 先に /asciinema-tools:record を実行します |
| バックアップがスキップされた | デーモンが実行されていない | /asciinema-tools:daemon-start を実行します |
| 変換に失敗する | .cast 形式が無効 | asciinema -V で asciinema のバージョンを確認します |
| 分析がタイムアウトする | 録画ファイルが大きい | --no-analyze を指定して、別途実行します |
| 権限が拒否される | 出力ディレクトリに書き込めない | ディレクトリの権限を確認します |
実行後の振り返り
このスキルの実行後、終了する前に次の点を確認してください。
- コマンドは成功しましたか? — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正してください。
- パラメーターや出力に変更はありましたか? — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーターテーブルを更新し、実態に合わせてください。
- 回避策が必要でしたか? — 別のフラグや追加手順など、即興の対応が必要だった場合は、次回の実行で同じ対応が不要になるよう、この SKILL.md を更新してください。
問題が実際に発生し、再現できる場合にのみ更新してください。推測に基づく更新はしないでください。
コメント
Markdown 対応