关于 record
record 是使用 asciinema 开始终端录制的技能。它检查所需程序是否已安装,收集输出路径和录制选项,再提供命令与操作说明;支持备份和追加录制。
主要功能
- 01检查是否已安装 asciinema
- 02设置输出路径和录制选项
- 03生成并展示录制命令
- 04支持标题和空闲时限选项
- 05支持备份和追加录制
适用场景
- 01录制终端会话以供后续查看
- 02录制带标题和空闲时限的演示
- 03追加到现有录制或启用备份
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill record安装后在 Claude Code 中输入/record确认已加载。
附带文件references/evolution-log.md
详细介绍
/asciinema-tools:record
使用 asciinema 启动终端录制会话。
自我进化技能:此技能会在使用过程中不断改进。如果说明有误、参数发生变化,或需要变通方案,请立即修复此文件,不要拖延。仅在问题真实且可复现时更新。
参数
| 参数 | 描述 |
|---|---|
file | 输出路径(例如 session.cast) |
-t, --title | 录制标题 |
-i, --idle-time-limit | 最大空闲时间(秒) |
--backup | 启用向 GitHub 流式备份 |
--append | 追加到现有录制 |
执行
使用用户选择的选项调用 asciinema-recorder 技能。
跳过逻辑
- 如果提供了
file-> 跳过阶段 1(输出位置) - 如果提供了
-t和-i-> 跳过阶段 2(选项)
工作流
- 预检:检查是否已安装 asciinema
- 位置:使用 AskUserQuestion 询问输出路径
- 选项:使用 AskUserQuestion 询问录制选项
- 生成:构建并显示录制命令
- 指导:显示分步说明
示例
# Basic recording
/asciinema-tools:record session.cast
# Recording with title and idle limit
/asciinema-tools:record -t "Demo Session" -i 30
# Recording with GitHub backup
/asciinema-tools:record session.cast --backup
故障排除
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 找不到 asciinema | 尚未安装 | brew install asciinema |
| 权限被拒绝 | 输出路径问题 | 检查输出目录的写入权限 |
| 录制无法启动 | 终端问题 | 确保在交互式终端中运行 |
执行后反思
此技能完成后,在结束前进行检查:
- 命令是否成功? — 如果没有成功,请修复导致失败的说明或错误表。
- 参数或输出是否发生变化? — 如果底层工具的接口发生变化,请更新用法示例和参数表,使其保持一致。
- 是否需要变通方案? — 如果你不得不临时变通(使用不同的标志、增加额外步骤),请更新此 SKILL.md,确保下次调用时无需重复采用相同的变通方案。
仅在问题真实且可复现时更新,不要基于猜测更新。
评论
支持 Markdown