用途:该技能面向需要以程序方式处理 Gemini CLI 输出的集成场景,帮助从结构化输出中提取响应内容、分析 token 用量与成本、解析工具调用统计、处理错误,并搭建自动化流水线。触发关键词包括 parse gemini output、json output、stream json、gemini stats、token usage、jq parsing、gemini response。
输出格式:标准 JSON 通过 --output-format json 使用,完成后返回单个 JSON 对象,包含 response、stats(models 的 api 与 tokens、tools 的调用统计、files 的行数变化)以及可选的 error(type、message、code)。stream-json 通过 --output-format stream-json 使用,为按行分隔的 JSONL 实时事件,事件类型有 init、message、tool_use、tool_result、error、result。
主要能力与用法:使用 jq 提取响应文本(如 gemini "query" --output-format json | jq -r '.response'),配合 jq -e 判断是否存在 error 并读取 error.message;统计总 token、缓存 token、可计费 token、按模型分组 token 与延迟、请求次数;统计工具调用总数、使用过的工具名、成功率、各工具调用次数与耗时;统计文件新增与删除行数。
流处理:可对 stream-json 输出按事件类型过滤,如 select(.type == "tool_result")、select(.type == "error")、筛选 assistant 消息内容;也可逐行读取实现工具调用与错误的实时监控。
限制与说明:技能要求先调用 gemini-cli-docs 并基于官方文档作答;示例中的具体字段、事件结构与命令均来自资料,实际字段以官方文档为准。除上述内容外,其他使用限制暂未提供。