SuperAPI AI 工具集

gh-issues

编程与开发

查看项目

更新于 11-06 16:22

技能介绍

用途

gh-issues 是一个围绕 GitHub CLI(gh)的 GitHub Issues 管理技能,目标是让 issue 的创建、检索、更新和全生命周期跟踪都能在命令行里高效完成。它额外提供「AI 会话上下文」存储机制:把任务进度、关键文件、下一步动作写成结构化评论保存到 issue 中,便于会话中断后冷启动恢复或交接。

主要能力

  • 快速命令参考:涵盖创建 issue(gh issue create -t ... -b ... -l ... -a @me)、列出进行中任务、查看 JSON、关闭并评论、编辑标签、开始工作等常用操作。
  • JSON 输出模式:强调解析时始终使用 --json,可指定 number、title、body、state、labels、assignees、milestone、author、createdAt、updatedAt、comments、url 等字段,并配合 --jq 做筛选与格式化。
  • 高级搜索过滤:支持 --search 组合条件,如按作者、创建日期区间(created:>=2026-01-01)、标签组合、排除标签(-label:wontfix)、里程碑等。
  • 批量操作:支持一次对多个 issue 增加标签、关闭,并可结合 xargs 对筛选结果批量处理。
  • Issue 到 PR 工作流:gh issue develop 123 --checkout 从 issue 创建并检出分支,提交时引用 issue 编号,gh pr create --fill 创建 PR 并自动关联,合并后关闭 issue。
  • 里程碑管理:通过 gh api repos/:owner/:repo/milestones 查看里程碑,并用 gh issue edit -m 指派。
  • AI 会话上下文:在 issue 评论中写入带 <!-- AI-CONTEXT:START --> / <!-- AI-CONTEXT:END --> 标记的模板,包含状态、进度清单、关键文件与行号、下一步、冷启动摘要;支持读取、创建、通过 API PATCH 更新已有评论。
  • 任务工作流标签:以 backlog、in-progress、blocked、review 等标签驱动 issue 状态流转。

使用方式

依赖 GitHub CLI 环境,命令示例均以 gh 为基础。典型流程为:读取 issue 及上下文 → 标记 in-progress 并创建分支 → 推进任务 → 暂停时把 .ai-context.md 作为评论写入 issue → 恢复时用 --json comments --jq 提取上下文继续。文档还列出常见错误及修正,如缺少 --json、循环调用代替多参数、对输出用 grep 而非 --jq、查询已关闭 issue 忘记 -s all、API 路径误用 {owner}/{repo} 而非 :owner/:repo、重复创建上下文评论而未更新已有评论等。

适用场景

适合习惯命令行的开发者、需要在多次 AI 编程会话之间交接任务上下文的用户,以及希望用标签和里程碑在 GitHub 上做轻量任务跟踪的团队。

限制

资料未提供该技能的安装方式、依赖版本、权限要求、平台支持范围及收费信息,相关内容暂未提供。