用途：gh-tool（GitHub）是 GitHub CLI 的封装，覆盖 PR、Issue、工作流、CI 检查、评审、合并与分支管理等操作，属于 @blogic-cz/agent-tools。
运行方式：通过 bun gh-tool 运行，需要将 @blogic-cz/agent-tools 作为 dev 依赖。禁止直接运行 gh，凭据守卫会拦截。认证使用 gh auth login 或 GITHUB_TOKEN 环境变量。可用 bun gh-tool commands 一次性导出完整命令树（子命令、标志、类型、选项、说明），无需反复查看 --help。
主要能力：PR 方面支持列表、状态、查看（含批量）、CI 检查（一次性快照或 --watch 监听，默认超时 600 秒）、等待可合并判定、失败诊断（--with-logs）、多 PR 事件流（--format jsonl）、关闭、草稿/就绪转换、合并（需 --confirm）、PR 栈查看/合并/解散、评审线程与回复、请求评审、创建与编辑 PR、评审分诊、重跑或触发检查、评审提交（approve/request-changes 需 --confirm，comment 需正文）。Gist 支持列表、查看、创建、编辑、删除（删除默认演练，需 --confirm）。工作流支持列表、查看、watch、日志、作业日志、重跑、取消。Issue 支持列表、查看、关闭、重开、评论、编辑、分诊。分支支持重命名（默认演练，需 --confirm）。
使用要点：跨仓库用 --repo <profile|owner/name>；有 PR 模板时创建/编辑 PR 优先用 --body-stdin 配合 heredoc，--body-file 仅用于已存在的文件；输出默认 TOON 节省 token，需要机器解析时加 --format json；错误响应含 hint、nextCommand、retryable 字段。
限制与注意事项：不要用 sleep 轮询工作流，应使用 workflow watch --run N；零检查项是一种状态而非错误；无任何运行记录时使用 pr trigger-checks，不要用无 ref 的 workflow run；matchesPrHead:false 与 checksObserved:false 不构成证据；待评审未提交前对 API 不可见，不能据 createdAt 判断此前扫描遗漏。其余未在资料中说明的内容暂未提供。