用途
该技能（/asciinema-tools:hooks）用于管理 Claude Code 的 hooks，服务于 asciinema-tools 的自动化需求。其核心目标是实现会话结束时的自动备份与自动转换。
主要能力
技能提供以下命令参数：
- install：将 hooks 添加到 settings.json
- uninstall：移除 asciinema-tools 的 hooks
- status：显示当前 hook 配置
- --backup-on-stop：会话结束时自动备份
- --convert-on-stop：会话结束时自动转换
- -y, --yes：跳过确认提示
Hook 定义方面，文档给出了一个 PostToolUse Hook（backup-on-stop）的配置示例：matcher 为 Bash，command 为 asciinema-backup-if-active。
使用方式
执行流程遵循以下步骤：Status（读取当前 ~/.claude/settings.json）、Action（通过 AskUserQuestion 询问操作类型）、Hooks（通过 AskUserQuestion 询问 hook 选择）、Execute（修改 settings.json）、Verify（确认更改已生效）。另有跳过逻辑：若已提供 action 则直接执行；若提供了 hook 类型标志则使用指定的 hooks。
文档提供的示例命令包括：
- /asciinema-tools:hooks status（查看当前 hook 状态）
- /asciinema-tools:hooks install --backup-on-stop（安装自动备份 hook）
- /asciinema-tools:hooks install -y（无提示安装）
- /asciinema-tools:hooks uninstall（移除所有 asciinema hooks）
适用场景
适用于需要在 Claude Code 会话结束时自动备份或转换 asciinema 录制的场景，尤其适合将其与 asciinema-tools 配合使用的用户。
限制与故障排查
文档列出以下已知问题：jq not found（原因：未安装 jq，解决：brew install jq）；Settings file not found（原因：~/.claude/ 不存在，解决：mkdir -p ~/.claude）；Hooks not working（原因：会话未重启，解决：重启 Claude Code 会话）；Backup not triggering（原因：没有活动录制，解决：先用 daemon 开始录制）。
自进化说明
该技能被描述为自进化技能，会随使用改进。若说明有误、参数发生偏移或需要变通方案，应立刻修复该文件而非延后。仅在遇到真实、可复现的问题时才更新。技能执行完成后需进行事后反思：命令是否成功、参数或输出是否变化、是否需要变通方案，仅在问题真实且可复现时才更新。