tether について
tetherは、asciinema-toolsの自動化フックを管理するClaude Codeスキルです。フックの追加・削除や、Claude Codeの設定確認に使えます。
主な機能
- 01自動化フックのインストール
- 02asciinema-toolsフックの削除
- 03フック設定の確認
- 04セッション終了時のバックアップ
- 05セッション終了時の変換
活用シーン
- 01設定済みフックの確認
- 02録画の自動バックアップ設定
- 03不要になったフックの削除
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill tetherインストール後、Claude Code で/tetherを入力して読み込まれたか確認します。
同梱ファイルreferences/evolution-log.md
詳細
/asciinema-tools:tether
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:tether status
# Install auto-backup hook
/asciinema-tools:tether install --backup-on-stop
# Install without prompts
/asciinema-tools:tether install -y
# Remove all asciinema hooks
/asciinema-tools:tether uninstall
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| jq が見つからない | jq がインストールされていない | brew install jq |
| 設定ファイルが見つからない | ~/.claude/ が存在しない | mkdir -p ~/.claude で作成します |
| フックが動作しない | セッションが再起動されていない | Claude Code のセッションを再起動します |
| バックアップが開始されない | アクティブな録画がない | まずデーモンで録画を開始します |
実行後の振り返り
このスキルの実行後、終了する前に確認してください。
- コマンドは成功しましたか? — 成功していない場合は、失敗の原因となった手順またはエラーテーブルを修正してください。
- パラメーターや出力に変更はありましたか? — 基盤となるツールのインターフェースにずれが生じた場合は、Usage の例と Parameters テーブルを実際に合わせて更新してください。
- 回避策が必要でしたか? — 異なるフラグや追加の手順など、工夫が必要だった場合は、次回同じ回避策が不要になるように、この SKILL.md を更新してください。
問題が実際に再現できる場合にのみ更新してください。推測に基づいて更新しないでください。
コメント
Markdown 対応