核心功能概述
Bitbucket Automation 是一套基于 Rube MCP（Composio）的企业级 DevOps 自动化解决方案，深度整合 Atlassian Bitbucket Cloud API，为开发团队提供从代码托管到协作审查的全链路自动化能力。
核心能力矩阵
| 模块 | 关键操作 | 典型场景 |
|------|---------|---------|
| **仓库管理** | 创建/删除仓库、配置隐私、项目关联 | 新项目初始化、归档清理 |
| **分支操作** | 列表查询、基于指定 commit 创建分支 | 功能分支管理、发布分支 |
| **Pull Request** | 创建、审查、差异对比、评论、状态过滤 | 代码评审工作流自动化 |
| **Issue 跟踪** | 创建、更新、评论、状态流转、分配 | 缺陷管理、任务追踪 |
| **工作区管理** | 成员列表、权限查询、空间发现 | 团队协作、权限审计 |
显著优势
1. BBQL 高级过滤：内置 Bitbucket Query Language 支持，可实现 name~"api" AND is_private=true 级别的精准数据筛选
2. 原生 OAuth 集成：通过 RUBE_MANAGE_CONNECTIONS 完成标准化授权，无需手动管理 API Token
3. 差异级审查：支持统一 diff 获取（GET_PULL_REQUEST_DIFF）和文件级统计（diffstat），配合行内评论实现完整代码评审
4. 智能分页处理：自动处理 Bitbucket 的分页机制（page/pagelen），支持大数据量场景
关键局限与注意事项
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **ID 格式陷阱** | UUID 必须带花括号 `{}`；PR ID 在部分工具为 integer，部分为 string | 严格遵循 schema 文档，创建 PR 时 reviewers 格式为 `[{"uuid": "{...}"}]` || **破坏性操作** | `DELETE_REPOSITORY` 不可逆且不删除 fork；`DELETE_ISSUE` 永久删除 | 执行前必须二次确认，建议先备份 |
| **字段不一致** | CREATE_ISSUE 用 `assignee`（username），UPDATE_ISSUE 用 `assignee_account_id`（UUID） | 对照工具文档确认参数类型 |
| **依赖前置条件** | Issue tracker 必须手动开启（`has_issues: true`） | 调用前验证仓库配置 |
| **大 diff 风险** | 超大代码变更可能耗尽上下文 | 始终设置 `max_chars` 参数（建议 50000） |
适用人群
- DevOps 工程师：构建 CI/CD 流水线中的自动化门禁
- 技术 Lead/架构师：批量管理多仓库 PR 审查、代码审计
- 开源维护者：Issue 自动分类、标签管理、贡献者响应
- 企业管理员：工作空间成员审计、权限合规检查
常规风险提示
- 速率限制：Bitbucket Cloud 存在 API 调用配额，批量操作需添加延迟
- 默认行为陷阱：
destination_branch省略时默认指向 repo 主分支（不一定是main）；新建仓库默认私有 - OAuth 作用域：部分操作需要特定权限，连接状态显示
ACTIVE不代表具备全部操作权限