用途
Issue Create 是一个面向 AI 编码智能体的操作技能,用于把发现的问题、改进需求或任务,转化成一份可被后续智能体或人员“无需再问”就能开始实现的 GitHub Issue。它强调 Issue 要同时写清“发生了什么”与“以什么标准算完成”。
主要能力
- 判断起票目标仓库:通过 gh repo view 查看仓库名、是否为 fork、当前用户权限与父仓库。对权限为 ADMIN/MAINTAIN/WRITE 的仓库可直接起票;其他人的仓库或 fork 的父仓库,仅在用户明确要求时起票,否则只给出草稿。
- 查重:用 gh issue list 搜索标题与正文,已有相同问题则追加证据而非新建;若与已关闭 Issue 同症状,则作为复发新建并引用原 Issue。
- 证据收集:记录版本(工具、运行时、目标 commit)、执行的命令与实际输出(长日志折叠)、复现步骤;无法复现时明确写明;推测需与已核实事实分开标注。
- 完成条件可执行化:不写“修复”“改进”这类模糊表述,而写具体检查命令与预期结果。
- 起票方式:使用 --body-file 传入正文,避免 shell 引号破坏内容;标签只用仓库已有标签(gh label list),不新建标签;完成后报告 Issue URL,若继续实现则进入 issue-to-merge 流程。
使用方式
技能规定了固定的 Issue 正文结构:
- 起きていること(发生了什么):1–3 句观察事实
- 根拠(证据):版本、执行命令、输出、复现步骤
- 期待する動作(期望行为):1–2 句
- 完了条件(完成条件):检查命令通过、可观察结果
- 範囲に含めないこと(范围外事项):可不写则省略 标题需写明对象与症状,不用“关于某事的件”“缺陷”这类含糊标题;一个 Issue 对应一组完成条件,可独立完成的工作应拆分。正文语言与仓库既有 Issue 保持一致。
适用场景
- 用户明确要求“建个 Issue”“起票”时。
- 准备开始实现,但发现没有对应 Issue 时(作为 issue-to-merge 流程的第一步)。
- 在完成委托工作的过程中,发现范围外的缺陷、文档错误或测试缺陷时。
限制
- 不依赖特定语言或技术栈,仅使用 git 与 gh。
- 安全缺陷不得开公开 Issue,需遵循仓库的 SECURITY.md 报告流程。
- 不得创建仓库中不存在的标签。
- 资料未提供计费、价格、平台支持范围、实际效果等其它信息。