SuperAPI AI 工具集

bootstrap

部署与运维

查看项目

更新于 10-16 02:18

技能介绍

用途

bootstrap 是 asciinema-tools 技能集中的一个预会话引导技能,作用是在进入 Claude Code 之前生成一个引导脚本,用于启动一次 asciinema 录制会话。它解决的是“录制需要在 Claude Code 之外启动”的问题:脚本在 Claude Code 外部运行,从而把录制与 Claude Code 会话解耦。

需要特别注意的是,录制内容的分块(chunking)由 launchd 守护进程负责,而不是由本技能负责。因此如果尚未完成守护进程配置,应先运行 /asciinema-tools:daemon-setup。

主要能力

  • 环境预检:检查 asciinema、zstd、git 三个工具是否安装,并检测名为 asciinema-chunker 的守护进程是否在运行。
  • 仓库上下文检测:判断当前是否处于 Git 仓库中,读取 origin 远程地址,解析出 owner/repo,检查孤立分支(默认 asciinema-recordings)是否已存在,以及本地克隆是否已存在。
  • 交互式仓库选择:根据检测结果,通过提问让用户选择使用已有孤立分支、创建新的孤立分支,或改用其他仓库。
  • 创建孤立分支:在需要时克隆仓库、创建孤立分支、提交初始化内容并推送,然后在本地克隆该分支并创建 chunks 目录。
  • 生成引导脚本:输出 tmp/bootstrap-claude-session.sh,脚本会写入守护进程所需配置(仓库地址、分支、本地仓库路径、工作区名、启动时间),并启动 asciinema 录制。
  • 显示使用说明:给出快速开始步骤、守护进程相关命令和常见问题排查表。

使用方式

命令形式为 /asciinema-tools:bootstrap。

支持参数:

  • -r, --repo:GitHub 仓库,例如 owner/repo。
  • -b, --branch:孤立分支名,默认 asciinema-recordings。
  • --setup-orphan:强制创建孤立分支。
  • -y, --yes:跳过确认提示。

典型流程:

  1. 一次性配置(如未完成):运行 /asciinema-tools:daemon-setup,配置带 Keychain 凭据的 launchd 守护进程。
  2. 在 Claude Code 中生成引导脚本:运行 /asciinema-tools:bootstrap,生成 tmp/bootstrap-claude-session.sh。
  3. 退出 Claude Code 并运行脚本:./tmp/bootstrap-claude-session.sh(注意不是 source)。脚本会写入守护进程配置并启动 asciinema 录制。
  4. 在录制会话中工作:运行 claude,守护进程会自动把分块推送到 GitHub。
  5. 退出两次:Ctrl+D 退出 Claude,再 exit 结束录制,守护进程推送最后一个分块。

跳过逻辑:同时提供 -r 和 -b 时跳过仓库选择;提供 -y 时跳过所有确认;提供 --setup-orphan 时强制创建孤立分支。

适用场景

适用于希望把 Claude Code 会话过程以 asciinema 录制并自动分块推送到 GitHub 的用户,尤其是需要将录制与 Claude Code 会话解耦、由后台守护进程自动处理分块与推送的场景。

限制与注意事项

  • 分块依赖 launchd 守护进程;守护进程未运行时,分块不会被推送到 GitHub,只能本地录制。
  • 脚本必须直接执行,不能 source,否则会报错。
  • 依赖 asciinema、zstd、git;缺失时需按排查表安装(如 brew install asciinema、brew install zstd)。
  • 创建孤立分支需要有效的 GitHub 认证,克隆失败时需运行 gh auth login。
  • 该技能被描述为“自进化技能”,鼓励在使用中发现指令错误、参数漂移或需要变通时立即修正本文件,并记录演化日志。
  • 资料未提供收费、价格、平台支持范围等更多信息。