SuperAPI AI 工具集

gh-issues

编程与开发

查看项目

更新于 10-16 07:43

技能介绍

用途

g-issues 面向需要批量处理 GitHub Issue 并自动产出修复 PR 的场景。它作为编排器运行,接收 owner/repo 与过滤参数,拉取符合条件的 Issue,然后为每个 Issue 派生一个子智能体去定位代码、实施最小修复、运行测试、提交并推送分支、创建 PR,随后监控 PR 的评审评论并加以回应。

主要能力

  • 参数解析:支持位置参数 owner/repo(省略时从当前 git remote 自动识别,兼容 HTTPS 与 SSH 格式)。
  • 过滤参数:--label、--limit(默认 10)、--milestone、--assignee(支持 @me)、--state(默认 open)。
  • 模式开关:--fork(指定用于推送分支和发起 PR 的 fork)、--watch(持续轮询新 Issue 与 PR 评审)、--interval(轮询间隔,默认 5 分钟)、--dry-run(仅展示)、--yes(跳过确认自动处理)、--reviews-only(跳过 Issue 处理,仅处理 PR 评审评论)、--cron(定时安全模式,派生后即退出不等待结果)、--model(指定子智能体模型)、--notify-channel(Telegram 频道 ID,仅发送含 PR 链接的最终结果)。
  • 去重与并发控制:检查已存在 PR、检查推送仓库上是否已有 fix/issue-{N} 分支、使用认领文件记录进行中的 Issue(超时 2 小时),正常模式最多并行 8 个子智能体。
  • 认证与 API:不使用 gh CLI,全部通过 curl 调用 GitHub REST API,GH_TOKEN 由环境变量注入或从 OpenClaw 配置文件读取。

使用方式

调用形式为 /gh-issues [owner/repo] [--label…] 等参数组合。执行流程分为六个阶段:

  1. 解析参数:解析位置参数与各 flag,推导 SOURCE_REPO、PUSH_REPO、FORK_MODE;--reviews-only 直接跳到第六阶段,--cron 强制启用 --yes。
  2. 拉取 Issue:解析 GH_TOKEN(环境变量,或从 ~/.openclaw/openclaw.json、/data/.clawdbot/openclaw.json 读取 skills.entries["gh-issues"].apiKey),通过 curl 请求 GitHub Issues API,并过滤掉返回结果中的 PR 条目。
  3. 展示与确认:以表格展示 Issue;--dry-run 到此结束;--yes 自动处理全部;否则用户输入 all、逗号分隔编号或 cancel。
  4. 预检:检查工作区是否干净、记录基础分支、验证远端可达、验证令牌有效性、检查是否已有对应 PR、是否已有对应分支、是否有未过期的认领记录。
  5. 并行派生子智能体:cron 模式下使用游标文件顺序挑选下一个符合条件的 Issue,派生后写入认领记录并立即退出;正常模式下最多并行 8 个,按完成情况分批补位。子智能体任务包含置信度评估(低于 7 分则跳过并说明原因)、理解 Issue、创建 fix/issue-{N} 分支、检索代码、实施最小修复、运行现有测试(失败重试一次)、提交、推送、创建 PR 等步骤。
  6. 监控 PR 并处理评审评论。

适用场景

  • 希望按标签或里程碑批量清理 Issue 的仓库维护者。
  • 在 fork 工作流中贡献修复:Issue 取自源仓库,分支推送到 fork,PR 面向源仓库。
  • 通过 cron 定时轮询新 Issue 并逐个后台处理。
  • 仅需回应已有 PR 的评审评论时使用 --reviews-only。
  • 先用 --dry-run 预览待处理 Issue,再决定是否执行。

限制

  • 依赖 GitHub REST API 与有效的 GH_TOKEN;401/403 会中止并提示检查 apiKey。
  • 不安装也不调用 gh CLI。
  • 子智能体对置信度低于 7 的 Issue 会跳过而不是强行修改。
  • 认领记录 2 小时过期,可能影响超长任务的去重判断。
  • 资料未提供该技能的价格、收费方式及具体性能指标。