play

/asciinema-tools:play

在专用的 iTerm2 窗口中播放终端录制内容。

自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生变化，或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

参数

参数	描述
file	.cast 文件的路径
-s, --speed	播放速度（例如，-s 6）
-i, --idle-time-limit	最大空闲时间（秒）
-l, --loop	循环播放
-r, --resize	使终端大小与录制内容匹配
-m, --markers	在标记处暂停

执行

使用用户选择的选项调用 asciinema-player 技能。

跳过逻辑

• 如果提供了 file -> 跳过第 1 阶段（文件选择）
• 如果提供了 -s -> 跳过第 2 阶段（速度选择）
• 如果提供了 -i/-l/-r/-m 中的任意一项 -> 跳过第 3 阶段（选项）

工作流

1. 预检：检查 iTerm2 和 asciinema
2. 发现：查找 .cast 文件
3. 选择：通过 AskUserQuestion 询问文件
4. 速度：通过 AskUserQuestion 询问播放速度
5. 选项：通过 AskUserQuestion 询问其他选项
6. 启动：通过 AppleScript 打开 iTerm2

示例

# Play recording at normal speed
/asciinema-tools:play session.cast

# Play at 6x speed
/asciinema-tools:play session.cast -s 6

# Play with idle time limit and looping
/asciinema-tools:play session.cast -i 2 -l

故障排除

问题	原因	解决方案
找不到 iTerm2	未安装	brew install --cask iterm2
窗口未打开	AppleScript 问题	授予 iTerm2 辅助功能权限
播放卡顿	文件较大	使用 -i 1 限制空闲时间

执行后回顾

此技能完成后，请在关闭前检查：

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

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