mcpField
T
tether

tether

github.com/terrylicaAgent 工作流139 次安装今天更新
代码仓库

关于 tether

tether 是用于管理 asciinema-tools 自动化钩子的 Claude Code 技能，可安装、移除钩子并查看其配置。

主要功能

  1. 01安装自动化钩子
  2. 02移除 asciinema-tools 钩子
  3. 03查看钩子配置
  4. 04启用会话结束时备份
  5. 05启用会话结束时转换

适用场景

  1. 01检查已配置的钩子
  2. 02设置录制内容自动备份
  3. 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"
      }
    ]
  }
}

执行

跳过逻辑
  • 如果提供了操作 -> 直接执行
  • 如果提供了钩子类型标志 -> 使用指定钩子
工作流
  1. 状态：读取当前的 ~/.claude/settings.json
  2. 操作：通过 AskUserQuestion 询问操作类型
  3. 钩子：通过 AskUserQuestion 询问钩子选择
  4. 执行：修改 settings.json
  5. 验证：确认更改已应用

示例

# 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未安装 jqbrew install jq
找不到设置文件~/.claude/ 不存在使用 mkdir -p ~/.claude 创建
钩子不起作用未重启会话重启 Claude Code 会话
未触发备份没有正在进行的录制先使用守护进程开始录制

执行后检查

此技能完成后，在结束前检查：

  1. 命令是否成功？ — 如果没有，请修复导致失败的指令或错误表。
  2. 参数或输出是否发生变化？ — 如果底层工具的接口发生变化，请相应更新用法示例和参数表。
  3. 是否需要采用变通方法？ — 如果不得不临时调整（使用不同的标志、增加额外步骤），请更新此 SKILL.md，避免下次调用时再次需要相同的变通方法。

仅在问题真实且可复现时进行更新，不要臆测。

评论

支持 Markdown