hooks について
hooks は、Claude Code の asciinema-tools 自動化フックを管理するスキルです。フックの導入・削除・状態確認に加え、セッション終了時のバックアップや変換を設定できます。
主な機能
- 01フックの導入・削除
- 02現在のフック状態の確認
- 03終了時バックアップの設定
- 04終了時変換の設定
- 05設定変更の検証
活用シーン
- 01録画の自動バックアップを有効化
- 02導入済みフックの確認や削除
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill hooksインストール後、Claude Code で/hooksを入力して読み込まれたか確認します。
同梱ファイルreferences/evolution-log.md
詳細
/asciinema-tools:hooks
asciinema-tools の自動化用 Claude Code フックを管理します。
自己進化するスキル:このスキルは使用を通じて改善されます。指示に誤りがある場合、パラメーターが変わった場合、または回避策が必要だった場合は、先送りせず、このファイルをすぐに修正してください。実際に再現可能な問題がある場合のみ更新してください。
引数
| 引数 | 説明 |
|---|---|
install | settings.json にフックを追加します |
uninstall | asciinema-tools のフックを削除します |
status | 現在のフック設定を表示します |
--backup-on-stop | セッション終了時に自動バックアップします |
--convert-on-stop | セッション終了時に自動変換します |
-y, --yes | 確認プロンプトをスキップします |
フックの定義
PostToolUse フック(backup-on-stop)
{
"hooks": {
"PostToolUse": [
{
"matcher": "Bash",
"command": "asciinema-backup-if-active"
}
]
}
}
実行
スキップ条件
- アクションが指定されている場合 -> そのまま実行します
- フックタイプのフラグが指定されている場合 -> 指定されたフックを使用します
ワークフロー
- 状態:現在の ~/.claude/settings.json を読み取ります
- アクション:アクションの種類を AskUserQuestion で尋ねます
- フック:フックの選択を AskUserQuestion で尋ねます
- 実行:settings.json を変更します
- 確認:変更が適用されたことを確認します
例
# Check current hook status
/asciinema-tools:hooks status
# Install auto-backup hook
/asciinema-tools:hooks install --backup-on-stop
# Install without prompts
/asciinema-tools:hooks install -y
# Remove all asciinema hooks
/asciinema-tools:hooks uninstall
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| jq が見つからない | jq がインストールされていない | brew install jq |
| 設定ファイルが見つからない | ~/.claude/ が存在しない | mkdir -p ~/.claude で作成します |
| フックが機能しない | セッションが再起動されていない | Claude Code セッションを再起動します |
| バックアップが実行されない | 録画がアクティブでない | まずデーモンで録画を開始します |
実行後の振り返り
このスキルの実行後、終了する前に確認してください。
- コマンドは成功しましたか? — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正してください。
- パラメーターや出力に変更はありましたか? — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーターテーブルを実際に合わせて更新してください。
- 回避策が必要でしたか? — 工夫が必要だった場合(異なるフラグ、追加の手順など)は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。
問題が実際に発生し、再現可能な場合のみ更新してください。推測で更新しないでください。
コメント
Markdown 対応