用途
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:跳过确认提示。
典型流程:
- 一次性配置(如未完成):运行 /asciinema-tools:daemon-setup,配置带 Keychain 凭据的 launchd 守护进程。
- 在 Claude Code 中生成引导脚本:运行 /asciinema-tools:bootstrap,生成 tmp/bootstrap-claude-session.sh。
- 退出 Claude Code 并运行脚本:./tmp/bootstrap-claude-session.sh(注意不是 source)。脚本会写入守护进程配置并启动 asciinema 录制。
- 在录制会话中工作:运行 claude,守护进程会自动把分块推送到 GitHub。
- 退出两次: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。
- 该技能被描述为“自进化技能”,鼓励在使用中发现指令错误、参数漂移或需要变通时立即修正本文件,并记录演化日志。
- 资料未提供收费、价格、平台支持范围等更多信息。