bitbucket-automation

Bitbucket Automation - Rube MCP 驱动的代码仓库自动化

技能概述

Bitbucket Automation 通过 Rube MCP (Composio) 为 Claude Code 提供完整的 Bitbucket 操作能力，支持自动化管理仓库、Pull Request、分支、Issue 和工作区，只需简单的自然语言指令即可完成复杂的代码协作流程。

适用场景

1. Pull Request 自动化工作流

当您需要自动化创建和管理 Pull Request 时，此技能可以批量创建 PR、指定审查者、获取代码 diff、添加审查评论。特别适用于需要频繁创建 PR 的开发团队，或者需要自动化代码审查流程的 CI/CD 场景。

2. 仓库和工作区批量管理

当您需要统一管理多个 Bitbucket 仓库时，此技能支持列出所有工作区和仓库、创建新仓库、设置隐私权限、列出成员信息。适用于 DevOps 工程师进行基础设施管理，或项目经理进行团队资源盘点。

3. Issue 跟踪和分支管理

当您需要自动化跟踪项目问题和创建功能分支时，此技能支持创建、更新、删除 Issue，以及从特定提交创建新分支。适用于敏捷开发团队的日常任务管理，或需要自动化分支策略的 Git 工作流。

核心功能

1. Pull Request 全生命周期管理

支持创建 PR 并指定审查者（使用 UUID 格式）、列出不同状态的 PR（OPEN/MERGED/DECLINED）、获取 PR 详细信息和代码 diff、添加行内代码审查评论。内置 BBQL 过滤支持，可按工作区、仓库、状态灵活筛选。

2. Bitbucket 仓库和工作区操作

支持列出所有可访问的工作区、在工作区内创建或删除仓库（注意删除操作不可逆）、使用 BBQL 查询语言过滤仓库列表、按用户角色（member/contributor/admin/owner）筛选、列出工作区成员用于审查者分配。

3. Issue 和分支自动化

支持创建 Bug、Enhancement、Proposal、Task 四种类型的 Issue，设置优先级和截止日期，添加评论和更新状态。支持从完整 SHA1 提交哈希创建分支，使用 BBQL 过滤和排序分支列表。

4. 智能查询和分页处理

支持 Bitbucket Query Language (BBQL) 进行复杂过滤，字符串值必须使用双引号。内置分页处理机制，默认每页 10 条结果，可设置 pagelen 参数（PR 最大 50，其他最大 100）获取完整数据。

5. 代码审查协作

支持获取 PR 的统一 diff（可设置 max_chars 限制避免上下文溢出）、获取变更文件的行数统计、创建 Markdown 格式的审查评论、支持行内代码评论和线程回复。

常见问题

如何使用 Rube MCP 连接 Bitbucket？

首先在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥。然后调用 RUBE_SEARCH_TOOLS 确认连接可用，再使用 RUBE_MANAGE_CONNECTIONS 配置 toolkit 为 bitbucket，按照返回的 OAuth 链接完成授权，最后确认连接状态为 ACTIVE 即可使用。

Bitbucket Automation 支持哪些操作？

此技能支持五大核心操作：Pull Request 管理（创建、列表、获取详情、获取 diff、添加评论）、仓库管理（列表、创建、删除）、Issue 管理（创建、更新、删除、评论）、分支管理（列表、创建）、工作区管理（列表成员、列出仓库）。所有操作都支持 BBQL 过滤和分页。

为什么审查者需要 UUID 格式而不是用户名？

Bitbucket API 使用 UUID 作为用户标识，格式必须包含大括号如 {123e4567-e89b-12d3-a456-426614174000}。可以通过 BITBUCKET_LIST_WORKSPACE_MEMBERS 获取成员的 UUID。注意在不同 API 中，创建 Issue 使用 username 字符串，而更新 Issue 使用 assignee_account_id UUID，这是 API 的设计差异。

BBQL 查询语法有什么特殊要求？

BBQL（Bitbucket Query Language）用于过滤列表结果，字符串值必须使用双引号包围，如 name~"api" 而不是 name~api。支持的操作符包括 =（精确匹配）、~（包含）、!=（不等于）、>, >=, <, <=，以及 AND/OR 组合。注意 repository 不是有效的 BBQL 字段，应使用 name。

Bitbucket API 有什么使用限制？

Bitbucket Cloud API 存在速率限制，大量批量操作应包含延迟。分页请求计入速率限制，应尽量减少不必要的页面获取。删除操作（仓库、Issue）不可逆，执行前需确认。PR 相关操作最大 pagelen 为 50，其他操作最大为 100。获取大型 diff 时建议设置 max_chars 参数（如 50000）避免上下文溢出。