用途
format 技能是 asciinema v3 .cast 格式的参考文档工具，用于展示该格式（NDJSON）的规范说明。它面向需要查阅 cast 格式细节、事件代码含义或解析方法的用户，通过命令 /asciinema-tools:format 调用。
主要能力
技能提供四个可查看的分区：
- header：显示 header 字段规范。
- events：显示事件代码的深入说明。
- parsing：显示 jq/bash 解析示例。
- all：显示完整的格式参考。
此外支持两个参数：
- -f, --file：使用指定的 .cast 文件作为示例。
- --live：在文件上运行解析示例。
使用方式
调用格式为 /asciinema-tools:format，可附带分区参数。示例：
- /asciinema-tools:format header —— 显示 header 格式。
- /asciinema-tools:format events —— 显示事件代码。
- /asciinema-tools:format parsing -f session.cast --live —— 对指定文件运行实时解析示例。
执行流程包含：选择分区（通过 AskUserQuestion）、选择示例文件（若为 parsing 分区）、展示所请求的文档。技能包含跳过逻辑：若已提供分区则跳过第一阶段（分区选择）；若在 parsing 下提供了 -f 则跳过第二阶段（示例文件选择）。
适用场景
适用于需要查阅 asciinema v3 .cast 格式规范、事件代码或解析示例的场合，例如编写或调试 cast 文件解析脚本时参考。
限制与故障排查
技能文档列出了常见问题及处理方式：
- 文件未找到：路径无效，应使用绝对路径或确保文件存在。
- 解析错误：NDJSON 无效，应检查文件是否为有效的 asciinema v3 格式。
- 无输出：缺少分区，需指定 header、events、parsing、all 之一。
该技能为自演进技能，会在遇到真实、可复现的问题时更新自身说明文件，包括修正错误指令、更新参数表、补充变通方法等。