用途:在任意项目中标准化 GitHub Issue 的创建与管理,保证每个 Issue 结构清晰、标签正确、内容可执行。
主要能力:创建 Issue(创建前先用 gh issue list --search 在 open 与 closed 中查重);查看详情与评论;带原因关闭;评论;指派或取消指派;添加或移除标签;triage(列未打标签的 open Issue 并建议类型标签);列表(默认操作,可按标签过滤)。
必要用法:先确认仓库上下文,执行 git remote get-url origin,从 SSH 或 HTTPS 远程地址解析出 owner/repo 并保存为 REPO;若不在 git 仓库或无远程地址,需手动提供。所有 gh issue 与 gh label 命令都加 -R "$REPO"。创建时用 gh issue create -R "$REPO" --title ... --label ... --body ...;编辑标签时用 --add-label / --remove-label,不要用 --label(会覆盖全部标签)。新 Issue 遵循模板:enhancement/feature 含 Summary、Proposed Solution、Additional context;bug 额外要求 Current behavior、Expected behavior、Steps to reproduce。至少打一个类型标签(bug、enhancement、documentation、question),可选状态标签(duplicate、good first issue、help wanted、invalid、wontfix)。
适用场景:需要统一团队 Issue 规范、减少重复提交、规范关闭与分类的项目。
限制:依赖 GitHub CLI(gh,未安装时引导至 https://cli.github.com);需有效仓库权限与认证,可能遇到 403/404、429 限流;未发现真实重复前不得创建,关闭必须附评论说明,合并重复需链接原 Issue,不得未经用户确认新建标签。官方未提供收费、价格等信息。