用途与定位 gh-issues 主要解决在命令行中高效管理 GitHub Issues 的问题。它基于 gh CLI，把常见的创建、查询、更新、关闭 issue 等操作整理成可直接使用的命令，并额外提供一项特色能力：把 AI 会话的工作上下文保存到 issue 评论中，实现任务暂停、恢复与交接。
主要能力
- 创建与维护 issue：例如使用 gh issue create 创建带标题、正文、标签和指派人的 issue；使用 gh issue edit 调整标签；使用 gh issue close 关闭并附带评论。
- 结构化输出：建议始终使用 --json 指定字段（如 number、title、body、labels、state、assignees、milestone、author、createdAt、updatedAt、comments、url），再配合 --jq 解析。
- 搜索与筛选：支持 using --search 按状态、作者、时间范围、标签、里程碑等条件筛选，例如 is:open author:username、created:>=2026-01-01、label:bug -label:wontfix、milestone:v2.0。
- 批量操作：可对多个 issue 同时添加标签或关闭，也可用 gh issue list 配合 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 123 -m "v2.0" 关联。
- AI 会话上下文：在 issue 评论中使用 AI-CONTEXT:START 与 AI-CONTEXT:END 标记保存上下文（状态、关键文件、已完成事项、下一步、恢复摘要），读取时用 gh issue view 配合 --jq 提取，更新时用 gh api 的 PATCH 请求修改已有评论，避免重复创建。
- 任务生命周期标签：使用 backlog、in-progress、blocked、review 等标签标识任务阶段，并提供开始、暂停/阻塞、完成对应的命令示例。
使用方式 整体以命令行操作为主：先通过 gh CLI 完成认证，再执行文档中给出的命令。解析输出时优先使用 --json 和 --jq；批量处理时把多个 issue 编号作为参数传入，而不是循环调用；查询已关闭的 issue 时要显式加 -s all。文档还提醒避免对输出使用 grep、API 路径中使用 :owner/:repo 占位符，以及更新已有上下文评论而非重复新建。
适用场景 适合在终端中跟踪开发任务的个人或团队，尤其是需要把 issue 状态、搜索筛选、批量维护与分支/PR 流程串联起来的场景；也适合需要跨会话恢复工作状态的 AI 辅助开发流程。
限制 资料未提供安装步骤、依赖版本、权限要求、平台差异、收费或价格信息，也未说明除 gh CLI 之外的集成方式，这些内容暂未提供。