SuperAPI AI 工具集

github-code

编程与开发

查看项目

更新于 10-21 12:51

技能介绍

用途

github-code 用于在 GitHub 仓库中开展源代码层面的工作,覆盖仓库、源代码、分支、提交、拉取请求(PR)、审查、差异、CI 以及仓库凭据等场景。它面向实现、源码修改与仓库协作任务,通过 git 和 gh 命令以及一组专用工具完成操作。

主要能力

该技能提供以下操作与对应工具或命令:

  • 创建 PR:使用 github_createPullRequest,而非 gh pr create。
  • 更新 PR 的标题、正文、基分支或状态:使用 github_updatePullRequest。
  • 将 PR 标记为就绪或草稿:使用 github_updatePullRequest,并设置 draft: false 或 draft: true。
  • 提交 PR 审查:使用 github_submitPullRequestReview。
  • 解决审查线程:使用 github_resolvePullRequestReviewThread。
  • 克隆缺失的仓库:使用 github_cloneRepository,而非 git clone 或 gh repo clone;若出现 Workspace 匹配错误,使用 switchWorkspace。

使用方式

  • 使用请求指定的仓库;否则通过独立命令 jr-rpc config get github.repo 读取 github.repo。
  • 向 gh 传递 --repo owner/repo;对本地仓库使用 git -C PATH。
  • 编辑前阅读每个适用的 AGENTS.md。
  • 保留无关工作;绝不删除引用或进行破坏性合并。
  • 仅在以下情况使用 --force-with-lease 强制推送:推送到 Junior 推送过的分支,或请求者指定的分支。
  • 使用仓库证据;只报告实际运行的检查。
  • 在调用 github_createPullRequest 之前先推送;绝不为机器人推送索要令牌。
  • 当错误信息指明某个工具时,使用该工具;仅在 GitHub 拒绝请求时更改权限。
  • 遇到目标不明确、缺少访问权限、破坏性工作或 GitHub 权限失败时停止。
  • 除非用户选择退出,否则推送已完成的工作并打开 PR。当工作完成且检查通过时,以就绪状态打开 PR;仅当工作、检查或决策尚未完成时打开草稿 PR。
  • 报告仓库、分支、PR、检查项以及跳过的检查。
  • 不要通过此技能安装或修复 GitHub 插件。

参考文档

按需打开以下参考:

  • 命令与权限:references/api-surface.md
  • 编辑、验证并打开 PR:references/workflow.md
  • 命令或权限失败:references/troubleshooting-workarounds.md

适用场景

适用于需要与 GitHub 仓库交互的编码与协作任务,例如实现功能、修改源码、管理分支与提交、创建和更新 PR、提交审查、解决审查线程、克隆仓库以及处理 CI 相关事项。

限制

  • 必须使用指定的仓库,或从 github.repo 配置读取。
  • 克隆仓库必须使用 github_cloneRepository,不能使用 git clone 或 gh repo clone。
  • 创建 PR 必须使用 github_createPullRequest,不能使用 gh pr create。
  • 强制推送仅限 --force-with-lease,且仅限特定分支。
  • 不得删除引用或进行破坏性合并。
  • 不得为机器人推送索要令牌。
  • 仅在 GitHub 拒绝请求时更改权限。
  • 遇到目标不明确、缺少访问权限、破坏性工作或 GitHub 权限失败时应停止。
  • 不得通过此技能安装或修复 GitHub 插件。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。