| name | github |
| description | Use when automating GitHub issues, pull requests, reviews, CI checks, labels, releases, or engineering collaboration loops through the GitHub CLI. |
| zh_description | 用于通过 GitHub CLI 自动化 Issue、PR、Review、CI 检查、标签和发布协作。 |
| version | 1.0.0 |
| author | seaworld008 |
| source | in-house |
| source_url | |
| tags | ["automation", "github", "workflow"] |
| created_at | 2026-03-15 |
| updated_at | 2026-06-29 |
| quality | 2 |
| complexity | intermediate |
GitHub
当任务涉及 GitHub 仓库协作（Issue/PR/CI/Review）时使用。GitHub 技能是连接本地代码环境与远程协作平台的桥梁，它通过封装 gh CLI 工具，使 Agent 能够执行从“创建 Issue 跟踪 Bug”到“合并经过评审的 PR”全生命周期的自动化管理。
安装
npx clawhub@latest install github
触发场景
- 创建、分配、更新 Issue 与 Milestone：快速将用户提出的功能点转化为可跟踪的条目。
- 批量处理 PR 评论、状态和合并策略：在多人评审的大型 PR 中，自动汇总反馈并提交合并请求。
- 读取 CI 失败日志并生成修复清单：当 GitHub Actions 运行失败时，自动拉取日志并利用
gh-fix-ci 技能进行修复。
- 汇总仓库活动用于周报或复盘：从
gh pr list 和 gh issue list 中提取数据，生成具有洞察力的协作报告。
- 发布管理 (Releases)：自动生成 Release Note 并发布新的版本包。
- 权限与项目维护：管理 Repo 的 Labels, Topics 以及 Collaborators。
推荐流程
- 环境准备 (Setup)：明确目标仓库（Owner/Repo）、当前分支、目标（如修复 CI 或处理 Review）。
- 状态感知 (Sensing)：拉取当前 PR / Issue / Workflow Run 的最新元数据。
- 策略生成 (Planning)：执行动作前先生成“变更预览”（Preview），描述将要修改的标签、关闭的 Issue 或触发的 Action，避免大规模误操作。
- 动作执行 (Execution)：调用
gh 指令执行具体动作。
- 状态同步 (Sync)：执行后回写结果（如回复评论、添加标签、同步状态到
MEMORY.md）。
本机 gh 认证优先
在任何 GitHub 自动化前，先执行：
gh auth status
如果仓库脚本需要 GitHub API，但环境里没有显式的 GITHUB_TOKEN / GH_TOKEN，优先复用本机 gh auth token，而不是直接走未认证请求。这样可以显著减少：
401 Unauthorized- 过早触发的 API rate limit
- 因匿名搜索受限导致的“误以为没有更新”
触发条件 / When to Use
- 代码提交前夕：需要创建 PR 以启动团队评审。
- CI/CD 构建失败：当 GitHub Actions 报错时，Agent 自动响应。
- 团队协作同步：需要快速查看当前仓库中有哪些
Unresolved 的 Issue。
- 发布周期点：需要从 Git Commits 中提取变更日志（Changelog）并创建 Release。
- 安全审计：定期扫描仓库的 Dependabot 警告并尝试自动修复。
核心能力 / Core Capabilities
1. 深度 Issue 管理 (Issue Lifecycle)
- 操作步骤：
- 使用
gh issue create 创建结构化 Issue。
- 使用
gh issue edit 增加标签（Label）、里程碑（Milestone）和受指派人（Assignee）。
