readable-github 用于通过 gh CLI 读取 GitHub 上的各类内容。它依赖 gh CLI(底层调用 GitHub REST/GraphQL API),由 CLI 处理认证、分页与速率限制;其使用政策将 API 访问排除在爬取条款之外。
用途与能力:读取仓库元数据、README 与文件树;读取 issue 及其评论和时间线;读取 pull request 的 diff、文件、行内评论,并涉及 GraphQL;还覆盖 discussions、代码(blob、tree、代码搜索)与 releases 等内容。
使用方式:先确认登录状态,运行 gh auth status,若未登录则运行 gh auth login。然后根据用户提供的 GitHub URL 形态选择对应参考文件:仓库根、README、文件树用 references/repo.md;issues 用 references/issues.md;pull 用 references/pulls.md;discussions 用 references/discussions.md;blob、tree、代码搜索用 references/code.md;releases 用 references/releases.md。Gist 链接(gist.github.com/...)应改用 readable-gist 技能。
通用建议:优先使用已有的 gh 子命令(如 gh repo、gh issue、gh pr 等),不覆盖的端点回退到 gh api。用 --json {fields} 缩小响应体积,各子命令的 --json 字段集可运行 gh {sub} view --help 查看。认证用户速率限制为每小时 5,000 次请求,可用 gh api rate_limit 查看当前用量。
限制:需已安装并登录 gh CLI;仅处理 GitHub 内容,Gist 需换用另一技能;关于安装步骤、具体定价与平台支持等资料暂未提供。