基于 Rube MCP 的 Bitbucket 全流程自动化：PR、分支、Issues 与工作区管理实战指南

AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载导读本文以 Agentic Awesome Skills 仓库中的 bitbucket-automation 技能 为核心系统讲解如何借助 Rube MCPComposio 的 Bitbucket toolkit将 Bitbucket Cloud 的日常开发运维——拉取请求PR创建与评审、仓库与工作区管理、分支操作、Issue 跟踪——全部交由 Agent 自动执行。读完本文你将掌握一套完整的工具调用链、全部核心参数语义、BBQL 查询语法以及避免踩坑的 ID 格式、分页、速率限制等实战要点可直接在自己的 Agent 配置中落地这套自动化方案。该技能以risk: critical级别收录于仓库标记date_added: 2026-02-27说明其涉及删除仓库、删除 Issue 等高风险操作使用前务必建立充分的安全确认机制。技能同时存在于 Claude 插件 与 通用插件 两个分发目录中内容保持一致可随插件一起安装使用。一、技能定位与前置条件该技能的能力边界非常明确自动执行 Bitbucket 上的仓库管理、Pull Request 工作流、分支操作、Issue 跟踪与工作区管理。它本身不直接调用 Bitbucket API而是通过 Rube MCP 这一中间层完成因此在动手前必须满足三个前置条件Rube MCP 必须已连接确认环境中存在RUBE_SEARCH_TOOLS工具存在激活的 Bitbucket 连接通过RUBE_MANAGE_CONNECTIONS以bitbuckettoolkit 建立连接始终先调用RUBE_SEARCH_TOOLSComposio 的工具 schema 可能随版本更新任何工作流开始前都应先拉取最新 schema而不是依赖本文或任何文档中的历史参数记忆。这一先搜索工具、再调用工具的原则与仓库中技能索引体系强调的 schema 漂移防护思路一致——工具契约以运行时返回为准文档中的参数说明是理解用途的辅助最终以RUBE_SEARCH_TOOLS的实际返回为准。二、建立 Bitbucket 连接Rube MCP 的接入成本极低只需在 MCP 客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点无需任何 API Key。连接建立的标准步骤验证 MCP 可用确认RUBE_SEARCH_TOOLS能够正常响应发起连接调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为bitbucket完成 OAuth 授权若返回的连接状态不是ACTIVE跟随返回的认证链接完成 Bitbucket OAuth 授权确认状态在运行任何工作流之前确认连接状态显示为ACTIVE。连接状态是所有后续操作的前提跳过第 4 步直接执行工具调用会得到一堆身份认证相关的报错且难以定位根因。三、核心工作流一Pull Request 全生命周期管理适用场景用户需要创建、评审或查看 Pull Request。工具调用序列步骤工具定位说明1BITBUCKET_LIST_WORKSPACES前置发现可访问的工作区2BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE前置定位目标仓库3BITBUCKET_LIST_BRANCHES前置确认源分支与目标分支存在4BITBUCKET_CREATE_PULL_REQUEST必需以标题、源分支创建 PR可指定评审人5BITBUCKET_LIST_PULL_REQUESTS可选按状态过滤列出 PROPEN / MERGED / DECLINED6BITBUCKET_GET_PULL_REQUEST可选获取指定 PR 的完整详情7BITBUCKET_GET_PULL_REQUEST_DIFF可选拉取 unified diff 用于代码评审8BITBUCKET_GET_PULL_REQUEST_DIFFSTAT可选获取变更文件及增删行数统计关键参数语义workspace工作区 slug 或 UUID所有操作必需repo_slugURL 友好的仓库名source_branch包含待合并变更的分支destination_branch目标分支省略时默认使用仓库的 main 分支注意仓库的默认分支不一定叫mainreviewers评审人对象数组元素含uuid字段stateBITBUCKET_LIST_PULL_REQUESTS的过滤值取OPEN、MERGED或DECLINEDmax_charsBITBUCKET_GET_PULL_REQUEST_DIFF的截断上限用于防止超大 diff 撑爆上下文窗口。实战陷阱reviewers期望的是带uuid键的对象数组而不是用户名数组[{uuid: {...}}]UUID 必须带花括号{123e4567-e89b-12d3-a456-426614174000}pull_request_id在 GET/DIFF 操作中是整数但会随 PR 列表返回大型 diff 会迅速淹没上下文窗口务必为GET_PULL_REQUEST_DIFF设置max_chars例如 50000这是评审大型 PR 时最容易犯、后果也最严重的失误。四、核心工作流二仓库与工作区管理适用场景列出、创建或删除仓库或探索工作区结构。工具调用序列BITBUCKET_LIST_WORKSPACES列出所有可访问工作区必需BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE列出仓库支持 BBQL 过滤必需BITBUCKET_CREATE_REPOSITORY创建新仓库可配置语言、可见性与项目设置可选BITBUCKET_DELETE_REPOSITORY永久删除仓库不可逆可选BITBUCKET_LIST_WORKSPACE_MEMBERS列出成员用于评审人指派或访问检查可选。关键参数语义workspace工作区 slug通过LIST_WORKSPACES获取repo_slug创建/删除时使用的 URL 友好名称qBBQL 查询过滤器例如name~api、project.keyPROJ、is_privatetruerole按用户角色过滤仓库member、contributor、admin、ownersort排序字段可加-前缀表示降序例如-updated_onis_private仓库可见性布尔值默认true私有project_keyBitbucket 项目键省略时使用工作区最早的项目。实战陷阱BITBUCKET_DELETE_REPOSITORY不可逆且不影响 fork 出来的仓库BBQL 字符串值必须用双引号包裹name~my-repo而不是name~my-reporepository不是合法的 BBQL 字段应使用name默认分页只有 10 条结果完整列表必须显式设置pagelenCREATE_REPOSITORY默认创建私有仓库公开仓库需显式设置is_private: false。五、核心工作流三Issue 全生命周期管理适用场景创建、更新、列出或评论仓库 Issue。工具调用序列BITBUCKET_LIST_ISSUES按 state、priority、kind、assignee 等过滤列出 Issue必需BITBUCKET_CREATE_ISSUE以标题、内容、优先级、类型创建 Issue必需BITBUCKET_UPDATE_ISSUE修改 Issue 属性state、priority、assignee 等可选BITBUCKET_CREATE_ISSUE_COMMENT向现有 Issue 添加 Markdown 评论可选BITBUCKET_DELETE_ISSUE永久删除Issue可选。关键参数语义issue_idIssue 的字符串标识符title、content创建时的必填字段kindbug、enhancement、proposal、taskprioritytrivial、minor、major、critical、blockerstatenew、open、resolved、on hold、invalid、duplicate、wontfix、closedassignee创建时使用 Bitbucket 用户名assignee_account_idUUID用于更新due_onISO 8601 格式的日期字符串。实战陷阱仓库必须启用 Issue 跟踪器has_issues: true否则 API 调用直接失败——这是最容易忽略的隐性前置条件CREATE_ISSUE用assignee用户名字符串而UPDATE_ISSUE用assignee_account_idUUID二者是完全不同的字段混用必然失败DELETE_ISSUE永久生效无法撤销state取值含空格on hold而非on_holdLIST_ISSUES中按assignee过滤时使用的是 account ID 而非用户名查询未分配 Issue 时使用字符串null。六、核心工作流四分支管理适用场景创建分支或探索分支结构。工具调用序列BITBUCKET_LIST_BRANCHES列出分支支持 BBQL 过滤与排序必需BITBUCKET_CREATE_BRANCH从指定 commit 哈希创建新分支必需。关键参数语义name分支名不带refs/heads/前缀例如feature/new-logintarget_hash作为分支起点的完整 SHA1 commit 哈希必须存在于仓库中qBBQL 过滤器例如name~feature/、namemainsort按name或-target.date提交日期降序排序pagelen每页 1–100 条默认 10。实战陷阱CREATE_BRANCH的target_hash必须是完整 commit 哈希而不是分支名分支名不要带refs/heads/前缀分支名必须符合 Bitbucket 命名规范字母数字及/、.、_、-BBQL 字符串值同样需要双引号name~feature/而非name~feature/。七、核心工作流五PR 评审评论含行内评论适用场景为 Pull Request 添加评审评论包括针对具体代码行的行内评论。工具调用序列BITBUCKET_GET_PULL_REQUEST获取 PR 详情确认其存在前置BITBUCKET_GET_PULL_REQUEST_DIFF审阅实际代码变更前置BITBUCKET_GET_PULL_REQUEST_DIFFSTAT获取变更文件清单可选BITBUCKET_CREATE_PULL_REQUEST_COMMENT发布评审评论必需。关键参数语义pull_request_idPR 的字符串 IDcontent_rawMarkdown 格式的评论正文content_markup默认markdown也支持plaintextinline行内评论对象含path、from、to字段parent_comment_id整数 ID用于对既有评论的线程化回复。实战陷阱pull_request_id在CREATE_PULL_REQUEST_COMMENT中是字符串但在GET_PULL_REQUEST中是整数跨工具调用时注意类型转换行内评论至少需要inline.pathfrom/to是可选行号parent_comment_id用于线程化回复顶层评论应省略行内评论中的行号引用的是 diff 中的行号不是源文件中的行号——这是代码评审自动化中最容易写错位置的一处。八、贯穿所有工作流的通用模式ID 解析原则在执行任何操作之前先把人类可读的名称解析为 ID工作区BITBUCKET_LIST_WORKSPACES获取 workspace slug仓库BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE配合q过滤器定位 repo slug分支PR 创建前用BITBUCKET_LIST_BRANCHES确认分支存在成员BITBUCKET_LIST_WORKSPACE_MEMBERS获取评审人指派所需的 UUID。分页模式Bitbucket 使用基于页码的分页而非游标分页使用page从 1 开始与pagelen每页条数参数默认页大小通常为 10显式设置pagelenPR 最大 50其他最大 100通过响应中的nextURL 或总条数判断是否还有更多页完整结果必须遍历所有页——遗漏翻页是列表类操作最常见的静默截断问题。BBQL 过滤Bitbucket Query Language 可用于列表类端点字符串值必须使用双引号name~pattern操作符精确、~包含、!不等于、、、、可用AND/OR组合name~api AND is_privatetrue。九、已知陷阱汇总一次讲清所有易错点ID 格式工作区slug 字符串如my-workspace或花括号 UUID{uuid}评审人 UUID必须带花括号{123e4567-e89b-12d3-a456-426614174000}Issue ID 是字符串PR ID 在部分工具中是整数、部分工具中是字符串commit 哈希必须是完整 SHA140 个字符。参数怪癖assignee与assignee_account_idCREATE_ISSUE用用户名UPDATE_ISSUE用 UUIDIssue 的state值含空格on hold而非on_holddestination_branch省略时默认取仓库 main 分支并非字面意义上的mainBBQL 中repository不是合法字段请用name。速率限制Bitbucket Cloud API 有速率限制大批量操作应加入延迟分页请求同样计入速率限制尽量减少不必要的翻页请求。破坏性操作BITBUCKET_DELETE_REPOSITORY不可逆且不删除 forkBITBUCKET_DELETE_ISSUE永久生效、无法恢复执行删除类操作前必须与用户确认。这也正是该技能在仓库中被标记为risk: critical的原因——Agent 在自动执行这些调用前必须建立明确的确认闸门。十、工具速查表任务工具关键参数列出工作区BITBUCKET_LIST_WORKSPACESq,sort列出仓库BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACEworkspace,q,role创建仓库BITBUCKET_CREATE_REPOSITORYworkspace,repo_slug,is_private删除仓库BITBUCKET_DELETE_REPOSITORYworkspace,repo_slug列出分支BITBUCKET_LIST_BRANCHESworkspace,repo_slug,q创建分支BITBUCKET_CREATE_BRANCHworkspace,repo_slug,name,target_hash列出 PRBITBUCKET_LIST_PULL_REQUESTSworkspace,repo_slug,state创建 PRBITBUCKET_CREATE_PULL_REQUESTworkspace,repo_slug,title,source_branch获取 PR 详情BITBUCKET_GET_PULL_REQUESTworkspace,repo_slug,pull_request_id获取 PR diffBITBUCKET_GET_PULL_REQUEST_DIFFworkspace,repo_slug,pull_request_id,max_chars获取 PR diffstatBITBUCKET_GET_PULL_REQUEST_DIFFSTATworkspace,repo_slug,pull_request_id评论 PRBITBUCKET_CREATE_PULL_REQUEST_COMMENTworkspace,repo_slug,pull_request_id,content_raw列出 IssueBITBUCKET_LIST_ISSUESworkspace,repo_slug,state,priority创建 IssueBITBUCKET_CREATE_ISSUEworkspace,repo_slug,title,content更新 IssueBITBUCKET_UPDATE_ISSUEworkspace,repo_slug,issue_id评论 IssueBITBUCKET_CREATE_ISSUE_COMMENTworkspace,repo_slug,issue_id,content删除 IssueBITBUCKET_DELETE_ISSUEworkspace,repo_slug,issue_id列出成员BITBUCKET_LIST_WORKSPACE_MEMBERSworkspace十一、典型使用场景与边界典型请求用户要求自动化 Bitbucket 的仓库、PR、分支、Issue 与工作区管理。推荐调用范式接到任务后先RUBE_SEARCH_TOOLS刷新 schema → 确认RUBE_MANAGE_CONNECTIONS中 Bitbucket 连接为 ACTIVE → 按上文各工作流的前置 → 必需 → 可选顺序逐步执行并在每次列表操作后解析 ID、在每次删除操作前与用户确认。使用边界与限制仅在任务明确匹配上述范围时使用该技能不要用它处理 Bitbucket 之外的领域不要把工具输出当作环境特定验证、测试或专家评审的替代品——自动化操作落地前仍需人工把关当输入、权限、安全边界或成功标准缺失时停下来向用户澄清而不是猜测后继续执行。结语这套 Bitbucket 自动化方案的核心价值在于把先查 schema → 解析 ID → 按序调用 → 确认破坏性操作这一套纪律固化成了可复用的工作流。无论你是要让 Agent 自动创建 PR 并贴上行内评审意见还是批量维护 Issue 状态、梳理仓库结构只要遵循本文梳理的工具调用链、参数语义与陷阱清单并在RUBE_SEARCH_TOOLS的实时 schema 指导下执行就能在避免上下文爆炸和误删风险的前提下稳定地跑通 Bitbucket 的日常自动化。完整技能原文可随时查阅仓库中的 bitbucket-automation/SKILL.mdClaude 插件分发版与 通用插件版。赞分享AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐基于 Rube MCP 与 Composio Folk Toolkit 的 Codex 工作流自动化实战指南基于 Rube MCP 与 Composio Folk Toolkit 的 Codex 工作流自动化实战指南 本文围绕 folk automation httpAI 技能AI 插件工作流自动化人工智能AI_NovelGenerator 本地部署与上手指南三步从零跑通 AI 长篇小说生成AI_NovelGenerator 本地部署与上手指南三步从零跑通 AI 长篇小说生成 AI_NovelGenerator 是一款基于大语言模型的长篇小说生成人工智能大模型AI 应用AI 写作RAG桌面应用基于 Rube MCP 与 Composio 实现 Teamcamp 工作流自动化的 Codex Skill 实战指南基于 Rube MCP 与 Composio 实现 Teamcamp 工作流自动化的 Codex Skill 实战指南 本指南围绕 awesome codexAI 技能AI 插件工作流自动化人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考