用途:当任务核心是与 GitHub 打交道时,优先使用 gh 命令,而非把范围局限在 Issue/PR。
主要能力与用法:仓库、Issue、PR、评论、release、workflow 等资源,先用 gh <group> --help 确认是否有现成子命令再执行;需要机器可读输出时优先用 --json,必要时配合 jq 整理字段。快速查看示例:gh repo view [owner/repo]、gh issue view <id|url>、gh pr view <id|url>、gh release list、gh workflow list。
创建前检查:创建 Issue 或 PR 前,先检查 GitHub 模板与表单(如 .github/ISSUE_TEMPLATE/、.github/PULL_REQUEST_TEMPLATE.md、.github/config.yml 等)及当前资源状态;标题与正文遵循 SKILL.md;确认代码、分支与提交状态和准备提交的内容一致。
创建 Issue(非交互):正文先写到本地 Markdown 文件(草稿优先 /tmp/*.md),标题用 --title 传入,创建与修改优先用 --body-file,例如 gh issue create --title "..." --body-file /tmp/issue-body.md,或 gh issue edit <id> --title "..." --body-file /tmp/issue-body.md;成功后输出完整 Issue URL。
创建 PR:需 git status 干净且当前分支已推送远端;正文先写本地文件,创建示例:gh pr create --title "feat(scope): short summary" --body-file /tmp/pr-body.md --base main --draft;修改用 gh pr edit <id> --title "..." --body-file /tmp/pr-body.md;成功后输出完整 PR URL。
更新标题或描述:修改前必须先读取当前标题/正文,文案按 SKILL.md 重新生成。
PR 审查:先看 PR 概览,再拉取 review/comment/thread 明细;必要时查看本地对应分支代码,查看前先 git fetch。整理审查意见时按严重程度从高到低、数字编号,每次最多展示 10 条,超出提示“还剩 N 条未展示”。回复 inline review comment 时优先在线程内回复;已完成的小改动回复简短,如 “Added in b771da1ea.”,commit 链接用 short_sha 形式。
限制:资料未提供安装方式、认证配置、权限要求、平台支持与收费信息;冷门参数可通过 gh --help、gh <group> --help、gh <group> <subcommand> --help 查询。