Github Skill

Github Skill 是什么？

Github Skill 指导 AI 使用 GitHub 官方 gh 命令行工具处理仓库事务。它集中说明 Pull Request、Issue、Actions 工作流和 GitHub API 的常用命令，并建议在不位于目标仓库目录时始终明确指定 owner/repo。

主要用途

• 查看 Pull Request 状态和 CI 检查结果。
• 列出工作流运行记录，定位失败步骤并读取日志。
• 查询和管理 Issue、Pull Request 等仓库对象。
• 使用 GitHub API 获取普通子命令没有暴露的数据。
• 通过 JSON 和 jq 输出便于脚本继续处理的结果。

环境要求

需要安装 gh CLI，并完成 GitHub 登录或提供有效令牌。令牌权限应与任务一致，只读查询不应使用不必要的写入权限。跨仓库操作时必须明确目标仓库，避免在错误项目中执行命令。

写入与高影响操作

创建或关闭 Issue、合并 Pull Request、重新运行工作流和修改发布内容都会影响协作流程。执行这些操作前应查看当前状态，确认仓库、分支和对象编号。涉及合并、删除或发布时，应保留人工确认。

限制与安全

Skill 是 gh CLI 的使用指引，不会替代仓库权限、分支保护和代码审查。API 返回结果可能分页，自动化时需要处理失败、限流和权限不足。令牌不能出现在日志或提交记录中。

许可证

ClawHub 当前版本没有声明许可证。gh CLI 和目标仓库有各自的授权与使用规则。

常见问题 FAQ

1. 必须安装 gh CLI 吗？

是，这个 Skill 的命令都围绕 gh CLI 展开。

2. 不在 Git 仓库目录中能使用吗？

可以，但应通过参数明确指定 owner/repo。

3. 能查看 CI 失败原因吗？

可以查看运行详情和失败步骤日志。

4. 能管理 Issue 和 Pull Request 吗？

可以，实际能力受账户权限和仓库规则限制。

5. 什么时候使用 gh api？

普通子命令没有所需字段或查询能力时，可以调用 GitHub API。

6. 怎样获得结构化输出？

多数命令支持 JSON 输出，并可用 jq 过滤字段。

7. 可以自动合并代码吗？

技术上可以，但应遵守分支保护和审查流程，并在执行前确认。

8. 怎样保护访问令牌？

使用安全凭据存储和最小权限，不要写进代码、日志或公开配置。

来源与核验说明

本条目根据 ClawHub 上 steipete 发布的 Github 1.0.0 内容整理，发布前已核对工具范围与写入风险。