用途:在 GitHub 仓库中创建、搜索、分类(triage)和管理 issue,可添加或移除标签、指派负责人、评论、关闭与重新打开,并支持将 issue 与 PR 关联及批量操作。
主要能力:查看与筛选 issue(按状态、标签、指派人、关键词搜索);创建 issue 并附带标题、正文、标签和指派;编辑标签与指派人;发表评论;关闭(含原因)和重新打开;通过 Closes #42、Fixes #42、Resolves #42 等关键词在 PR 合并时自动关闭 issue;用 gh issue develop 42 --checkout 从 issue 创建分支;提供 triage 流程(列出待处理 issue、阅读分类、打标签优先级、指派、评论)以及用脚本批量关闭等操作。
使用方式:每个操作先给出 gh 命令,再给出 curl 的等效 REST 调用。可直接使用已认证的 gh;否则设置 GITHUB_TOKEN 后调用 api.github.com。命令示例:gh issue list --state open --label "bug";gh issue create --title "..." --body "..." --label "bug,backend" --assignee "username";gh issue edit 42 --add-label "priority:high,bug";gh issue comment 42 --body "...";gh issue close 42。REST 对应端点如 GET/POST /repos/{o}/{r}/issues、POST /repos/{o}/{r}/issues/N/labels、POST /repos/{o}/{r}/issues/N/assignees、POST /repos/{o}/{r}/issues/N/comments、PATCH /repos/{o}/{r}/issues/N 以及 GET /search/issues?q=...。
适用场景:需要在仓库中批量整理 issue、执行 triage、在无 gh 环境下用 REST 完成同等操作,或在自动化脚本中处理 issue。
限制:需先用 GitHub 完成认证(另见 github-auth 技能);需位于带 GitHub 远程的 git 仓库内或显式指定仓库;REST 的 /issues 端点也会返回 PR,需在结果中过滤掉带 pull_request 的条目;批量操作需自行编写 shell 脚本,未提供内置批处理命令;费用与平台限制暂未提供。