SuperAPI AI 工具集

issue-create

编程与开发

查看项目

更新于 11-12 23:16

技能介绍

用途

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 报告流程。
  • 不得创建仓库中不存在的标签。
  • 资料未提供计费、价格、平台支持范围、实际效果等其它信息。