用途
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 上做轻量任务跟踪的团队。
限制
资料未提供该技能的安装方式、依赖版本、权限要求、平台支持范围及收费信息,相关内容暂未提供。