SuperAPI AI 工具集

github-repository-management

部署与运维

查看项目

更新于 10-16 08:51

技能介绍

用途

该技能用于通过 GitHub MCP 管理仓库协作流程,适用于当用户要操作 GitHub 仓库协作流程而不是修改本地代码实现时。

适用场景

  • 基于 GitHub MCP 查询 TencentBlueKing/bk-ci 或其他仓库信息。
  • 创建、更新或补充 Issue。
  • 基于当前本地改动起草或创建 PR。
  • 查看 PR 评论、review、check runs,并回复评审意见。
  • 做合并前检查,确认是否满足合并条件。

不适用场景

  • 只修改本地代码实现,不涉及 GitHub 协作动作。
  • 只讨论 commit message、提交边界或本地 Git 历史整理。
  • 需要深入做正确性审查,此时应切到代码 review 流程。
  • 未经用户确认直接执行有副作用的 GitHub 写操作。

使用方式

该技能关注的是“本地仓库上下文 + GitHub MCP 协作动作”的闭环,不是 GitHub 功能总览。

在 BK-CI 仓库里,默认仓库上下文是 TencentBlueKing/bk-ci,默认基线分支通常是 master;若用户另有指定,以用户指定为准。

代码事实优先来自当前本地仓库;Issue、PR、评论、check runs 等协作事实优先通过 GitHub MCP 获取。

所有写操作都遵循“先读后写”:

  • 先确认 owner/repo。
  • 先搜索重复 Issue、现有 PR、相关评论。
  • 先向用户展示拟提交内容。
  • 获得确认后再真正创建或更新。

PR 主链路要同时补齐本地信息:分支名、目标分支、变更摘要、验证结果、关联 Issue。

不确定是否能直接合并时,优先创建 draft PR,而不是假设已可合并。

具体工具选择、模板和流程细节放在 reference/workflows.md。

高信号规则

  • GitHub MCP 负责远端协作状态,本地仓库负责代码与测试事实,二者不要混用。
  • 创建 Issue 前必须先查重;创建 PR 前必须先看本地 diff、目标分支和现有 PR 状态。
  • Issue 评论与 PR review comment 是两类动作,回复时不要选错工具。
  • 合并前至少确认 review 状态、check runs、冲突风险和用户授权。
  • 标签、assignee、milestone、issue type 只有在仓库中已知可用时才填写,不要臆造。

关键陷阱

  • 只看本地代码就直接提 Issue / PR,导致远端上下文缺失。
  • 把普通 PR 评论当成代码 review comment,或反过来。
  • 没有向用户展示最终标题和正文就直接执行写操作。
  • 在 CI 未确认、评审未收敛时默认执行合并。

延伸阅读

  • 核心工作流与模板:reference/workflows.md
  • 如需整理提交表达:看 git-commit-specification
  • 如需做 PR 正确性审查:走 GitHub PR review 流程,而不是把审查细则塞进本 skill