github

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。

推荐流程

1. 环境准备 (Setup)：明确目标仓库（Owner/Repo）、当前分支、目标（如修复 CI 或处理 Review）。
2. 状态感知 (Sensing)：拉取当前 PR / Issue / Workflow Run 的最新元数据。
3. 策略生成 (Planning)：执行动作前先生成“变更预览”（Preview），描述将要修改的标签、关闭的 Issue 或触发的 Action，避免大规模误操作。
4. 动作执行 (Execution)：调用 gh 指令执行具体动作。
5. 状态同步 (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)

• 操作步骤：
  1. 使用 gh issue create 创建结构化 Issue。
  2. 使用 gh issue edit 增加标签（Label）、里程碑（Milestone）和受指派人（Assignee）。