SuperAPI AI 工具集

bitbucket-automation

编程与开发

查看项目

更新于 10-15 10:16

技能介绍

Bitbucket Automation 是一个用于自动化 Bitbucket 操作的技能,通过 Rube MCP 调用 Composio 的 Bitbucket 工具包,覆盖仓库管理、拉取请求工作流、分支操作、议题跟踪以及工作区管理。

用途 该技能用于在 Bitbucket 上执行日常协作与运维操作,包括创建与查看拉取请求、管理仓库与工作区、创建与更新议题、创建分支,以及对拉取请求进行评论(含行内代码评论)。

前置条件 使用前需要满足以下条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 并使用 bitbucket 工具包建立有效的 Bitbucket 连接;应始终先调用 RUBE_SEARCH_TOOLS 以获取当前的工具 schema。

设置方式 获取 Rube MCP:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥,添加端点即可工作。随后确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用;调用 RUBE_MANAGE_CONNECTIONS 并指定 bitbucket 工具包;若连接状态不是 ACTIVE,则按返回的授权链接完成 Bitbucket OAuth;在运行任何工作流前确认连接状态为 ACTIVE。

主要能力

  1. 管理拉取请求:可创建 PR,指定标题、源分支与可选评审人;可按状态(OPEN、MERGED、DECLINED)列出 PR;可获取 PR 详情、统一 diff 以及变更文件与增删行数的 diffstat。
  2. 管理仓库与工作区:可列出可访问的工作区、列出仓库(支持 BBQL 过滤)、创建仓库(可设置语言、可见性与项目),以及删除仓库。还可列出工作区成员,用于评审人分配或权限检查。
  3. 管理议题:可列出、创建、更新、评论与删除议题,支持按状态、优先级、kind、负责人过滤,议题属性包括 kind(bug、enhancement、proposal、task)、priority(trivial、minor、major、critical、blocker)、state 等。
  4. 管理分支:可列出分支(支持 BBQL 过滤与排序),并可从指定提交哈希创建分支。
  5. 带评论的 PR 审查:在获取 PR 详情与 diff 后,可发表评审评论,支持 Markdown、行内代码评论以及通过 parent_comment_id 进行线程回复。

使用方式与要点 技能以工具序列的方式组织操作,例如创建 PR 前需依次解析工作区、仓库与分支;ID 解析方面,工作区、仓库、分支与成员通常需先从可读名称解析为对应标识;分页采用 page 与 pagelen 参数(page 从 1 开始,默认每页通常为 10);BBQL 过滤中字符串值必须使用双引号,支持 =、~、!=、>、>=、<、<= 等运算符并以 AND / OR 组合。

限制与注意事项 评审人参数需为含 uuid 键的对象数组而非用户名,UUID 需带花括号;destination_branch 省略时默认使用仓库主分支而非字面意义上的 main;大 diff 需设置 max_chars 以避免上下文过载;创建分支需完整的 40 位 SHA1 提交哈希而非分支名,且不应包含 refs/heads/ 前缀;议题追踪必须在仓库上启用,否则 API 调用失败;创建议题用 assignee(用户名),更新议题用 assignee_account_id(UUID),二者不同;议题的 state 值包含空格,如 "on hold"。删除仓库与删除议题均为不可逆操作,执行前应先与用户确认。Bitbucket Cloud API 存在速率限制,批量操作应加入延迟并减少不必要的分页请求。