关于 format
用于查看 asciinema v3 .cast 格式参考文档的技能，可按需展示头部、事件代码、解析示例或完整规范。适合需要查阅格式细节或分析录制文件的开发者。
主要功能
- 01查看头部字段规范
- 02查阅事件代码说明
- 03获取 jq 和 bash 解析示例
- 04展示完整格式参考
- 05可指定示例文件并运行解析
适用场景
- 01查阅 .cast 文件头部字段
- 02了解事件代码及其含义
- 03使用 jq 或 bash 解析录制文件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/format确认已加载。
附带文件references/evolution-log.md
详细介绍
/asciinema-tools:format
显示 asciinema v3 .cast 格式的参考文档。
自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生偏差，或需要变通方案，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。
参数
| 参数 | 描述 |
|---|---|
header | 显示标头字段规范 |
events | 深入介绍事件代码 |
parsing | 显示 jq/bash 解析示例 |
all | 显示完整的格式参考 |
-f, --file | 使用指定的 .cast 文件作为示例 |
--live | 在文件上运行解析示例 |
执行
调用 asciinema-cast-format 技能，并传入用户选择的章节。
跳过逻辑
- 如果已提供章节 -> 跳过阶段 1（选择章节）
- 如果提供了
-f且选择了parsing-> 跳过阶段 2（示例文件）
工作流
- 选择：使用 AskUserQuestion 选择章节
- 示例：使用 AskUserQuestion 选择示例文件（如果选择了 parsing）
- 显示：显示所需文档
示例
# Show header format
/asciinema-tools:format header
# Show event codes
/asciinema-tools:format events
# Parse specific file with live examples
/asciinema-tools:format parsing -f session.cast --live
故障排除
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 找不到文件 | 路径无效 | 使用绝对路径或确保文件存在 |
| 解析错误 | NDJSON 无效 | 检查文件是否为有效的 asciinema v3 格式 |
| 无输出 | 未指定章节 | 指定以下章节之一：header、events、parsing、all |
执行后复盘
此技能执行完毕后，请在结束前检查：
- 命令是否成功？ — 如果没有，请修复导致失败的说明或错误表。
- 参数或输出是否发生变化？ — 如果底层工具的接口发生偏移，请相应更新用法示例和参数表。
- 是否需要变通方案？ — 如果你需要临时变通（使用不同的标志、增加步骤），请更新此 SKILL.md，以便下次调用时无需重复采用相同的变通方案。
仅在问题真实且可复现时进行更新，不要猜测。
评论
支持 Markdown