前言¶

Agent 里让模型直接调用 GitHub API 或 gh 命令查仓库、issue、PR 时，返回的原始 JSON 往往又长又啰嗦：一个 PR 详情可能带几十KB 字段，全塞进上下文，几轮下来 Token 就烧光了。更麻烦的是，模型手一滑执行了写操作（关 issue、合并 PR、删分支），在共享环境里是不可逆的事故。

下面介绍的这个 Skill 就是冲着这两个问题来的。

这是什么¶

GitHub CLI 省 Token 只读工具集（坐标 @indiv-yaoyao/gh-cli-readonly-agent，版本 1.0.0）是一个面向 AI Agent 的 GitHub CLI 只读技能，由社区开发者 user_64e5b706 发布，分类 dev-programming，来源标记为 community。

它的思路是：Agent 不直接碰原始 API 输出，而是通过这个 Skill 提供的只读命令查 GitHub，Skill 内部做缓存和字段裁剪，把返回内容压到只保留必要字段，从而显著降低 Token 消耗。

官方简介原文是：

AI Agent专用GitHub CLI只读技能，内置缓存与字段裁剪，极致省Token。严禁写操作，支持跨平台与自动降级。

SkillHub 页面数据显示：评分 100000，下载 146453 次，安装数 0。安装数为 0 可以理解为该页面统计口径尚未产生安装记录，不代表没人在用。

核心功能¶

根据已抓取的官方资料，该 Skill 的能力可以归纳为四点。

1、只读约束。Skill 严禁写操作，只暴露查询类命令。这是它最主要的安全设计：Agent 即便想在共享环境里改 GitHub 状态，也没有入口。

2、内置缓存。相同查询短期内直接返回缓存结果，减少重复请求。对 Agent 反复确认同一状态（比如盯 PR 是否合并）的场景比较实用。

3、字段裁剪。返回内容只保留关键字段，剔除 JSON 里的冗余部分。这是省 Token 的主要手段，而非靠模型自己挑字段。

4、跨平台与自动降级。支持 Windows / macOS / Linux，当 gh 命令不可用或接口不可用时自动降级，不会直接报错中断 Agent 流程。

另有元数据标签 requires_api_key=false，即使用该 Skill 本身不需要单独申请 API Key。

安装与启用¶

需要说明：本次写作时尝试访问官方页面（https://api.skillhub.cn/indiv-yaoyao/gh-cli-readonly-agent 与 https://www.skillhub.cn/skills/indiv-yaoyao/gh-cli-readonly-agent）均未抓取成功，已抓取资料中也未包含具体的安装命令、目录路径或配置字段。

因此这里不给出未经核实的安装命令，只说明一般情况：

• 该 Skill 基于通用 SKILL.md 格式，通常以 skills 目录形式挂载到 Agent 运行环境（如 Cursor、Claude Code 等），具体挂载方式以所用 Agent 的 SKILL.md 机制为准。
• 运行环境需能调用 GitHub CLI（gh）。Skill 的自动降级机制针对的就是 gh 缺失或命令失败的场景，但完全没装 gh 时查询本身无法执行。
• 建议在读取官方页面后，再执行其中的安装步骤，并确认本机 gh auth login 已完成，否则只读查询也会因未授权而失败。

典型用法¶

已抓取资料中没有给出具体的调用示例或命令清单，以下内容仅基于官方简介中”只读、带缓存、字段裁剪”的定位，描述其典型交互模式，具体命令语法请以官方页面为准。

1、Agent 收到”查一下某个 PR 的状态”这类只读请求时，改走该 Skill 提供的查询入口，而不是让模型自己拼 gh 命令或调 API。

2、Skill 内部执行 gh 查询，命中缓存则直接返回，未命中则发起真实请求。

3、返回给模型的内容是裁剪后的精简结果，只含任务需要的字段。

4、当 gh 命令不存在或接口异常时，Skill 自动降级，Agent 流程不中断。

适用场景与注意¶

适合的场景：

• 让 Agent 在长对话里反复查询 GitHub 仓库、issue、PR 状态，Token 消耗是主要瓶颈。
• 共享或自动化环境中，需要对 Agent 的 GitHub 操作做硬性只读约束。
• 需要跨平台跑同一套 Agent 流程，不希望为环境差异写分支代码。

需要注意的点：

• 评分与下载量来自 SkillHub 页面快照（评分 100000，下载 146453），数据会随时间变化，且该页面显示安装数为 0，采用前建议自行复核。
• 它是只读工具集，无法替代写操作。需要合并 PR、改 issue 状态时，要另找带授权的路径。
• 缓存意味着短期内读到的是旧状态，对时效敏感的查询要留意。
• 自动降级是容错机制，不等于功能完整。gh 未安装时降级只能保证不报错，查不到数据。

结尾¶

这个 Skill 的价值在于把”查 GitHub”这件事从模型的上下文预算里解放出来：用缓存减少重复查询，用字段裁剪砍掉冗余输出，用硬性只读约束堵住写操作风险。对于 Token 消耗敏感、又需要频繁读 GitHub 的 Agent 工作流，是一个可以低成本接入的方案。

官方地址：https://api.skillhub.cn/indiv-yaoyao/gh-cli-readonly-agent
SkillHub 页面：https://www.skillhub.cn/skills/indiv-yaoyao/gh-cli-readonly-agent