mcpField
H
hooks

hooks

github.com/terrylicaエージェントワークフロー154 回インストール今日更新
リポジトリ

hooks について

hooks は、Claude Code の asciinema-tools 自動化フックを管理するスキルです。フックの導入・削除・状態確認に加え、セッション終了時のバックアップや変換を設定できます。

主な機能

  1. 01フックの導入・削除
  2. 02現在のフック状態の確認
  3. 03終了時バックアップの設定
  4. 04終了時変換の設定
  5. 05設定変更の検証

活用シーン

  1. 01録画の自動バックアップを有効化
  2. 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 フックを管理します。

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

引数

引数説明
installsettings.json にフックを追加します
uninstallasciinema-tools のフックを削除します
status現在のフック設定を表示します
--backup-on-stopセッション終了時に自動バックアップします
--convert-on-stopセッション終了時に自動変換します
-y, --yes確認プロンプトをスキップします

フックの定義

PostToolUse フック(backup-on-stop)
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "asciinema-backup-if-active"
      }
    ]
  }
}

実行

スキップ条件
  • アクションが指定されている場合 -> そのまま実行します
  • フックタイプのフラグが指定されている場合 -> 指定されたフックを使用します
ワークフロー
  1. 状態:現在の ~/.claude/settings.json を読み取ります
  2. アクション:アクションの種類を AskUserQuestion で尋ねます
  3. フック:フックの選択を AskUserQuestion で尋ねます
  4. 実行:settings.json を変更します
  5. 確認:変更が適用されたことを確認します

例

# 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 セッションを再起動します
バックアップが実行されない録画がアクティブでないまずデーモンで録画を開始します

実行後の振り返り

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

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

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

コメント