关于 bitbucket
供 Agent 使用的 Bitbucket 技能，先识别仓库使用 Cloud 还是 Data Center，再加载对应的详细指引。优先使用可用的已认证 Bitbucket MCP 工具，并提供基于令牌的 API 备用步骤。
主要功能
- 01区分 Cloud 与 Data Center
- 02优先使用可用的已认证 MCP 工具
- 03加载对应产品的详细技能
- 04提供基于令牌的 API 备用方案
- 05识别产品专用 PR 工具
适用场景
- 01判断正在使用的 Bitbucket 产品
- 02选择对应的 API 和仓库格式
- 03使用指定工具创建拉取请求
MCP 相关
该技能要求在可用时优先使用已认证的 Bitbucket MCP 工具，不依赖特定服务器名称。若这些工具不可用，则提供基于令牌的 REST API 指引。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/bitbucket确认已加载。
附带文件.plugin/plugin.jsonREADME.md
详细介绍
当 Agent 环境中有经过身份验证的 Bitbucket MCP 工具可用时，请优先使用。通过工具是否可用来检测，不要依赖特定的 MCP 服务名称。同时，识别 Cloud 还是 Data Center，并加载匹配的详细技能。仅当 Bitbucket MCP 工具不可用，或明确需要原始 API 或 curl 访问时，才使用令牌和直接 API 说明。
你正在使用 Bitbucket。它有两个不同的产品，行为各不相同：
- Bitbucket Cloud（
bitbucket.org）——使用BITBUCKET_TOKEN环境变量进行身份验证。 - Bitbucket Data Center（可自托管的 Bitbucket Server）——使用
BITBUCKET_DATA_CENTER_TOKEN环境变量进行身份验证。
它们使用不同的 REST API、仓库标识符、Git 远程 URL 格式和拉取请求工具，因此必须先确定你使用的是哪一个，然后加载匹配的详细技能以获取完整说明。
步骤 1 — 检测你使用的是哪种 Bitbucket
首先，根据仓库主机或可用的 Bitbucket MCP 工具上下文识别产品。若要回退到令牌方式，请检查存在哪个令牌环境变量。环境变量名称区分大小写，因此请忽略大小写进行查找：
env | grep -i 'bitbucket' || echo "no bitbucket token found"
- 如果设置了
BITBUCKET_DATA_CENTER_TOKEN变量（任意大小写）→ 你使用的是 Bitbucket Data Center。 - 否则，如果设置了
BITBUCKET_TOKEN变量 → 你使用的是 Bitbucket Cloud。 - 如果两者都未设置，请先询问用户如何向 Bitbucket 进行身份验证。
之后引用令牌时，请使用环境中实际存在的变量名称（包括其准确的大小写）。
步骤 2 — 加载详细技能
确定环境后，使用 invoke_skill 工具加载匹配的技能，以获取有关 API 调用、经过身份验证的 Git 远程地址以及创建拉取请求的完整说明：
- Bitbucket Cloud → 调用
bitbucket-cloud技能。 - Bitbucket Data Center → 调用
bitbucket-data-center技能。
快速参考（回退方案）
如果无法加载详细技能，以下是基本信息。始终使用 Bitbucket API（而非 Web 浏览器），并始终使用列出的 PR 工具创建拉取请求。
| Bitbucket Cloud | Bitbucket Data Center | |
|---|---|---|
| 令牌环境变量 | BITBUCKET_TOKEN | BITBUCKET_DATA_CENTER_TOKEN |
| 主机 | bitbucket.org | 自托管域名 |
| REST API 基础 URL | https://api.bitbucket.org/2.0 | https://<host>/rest/api/1.0 |
| 仓库标识符 | workspace/repo_slug | PROJECT/repo_slug（项目键） |
| 拉取请求工具 | create_bitbucket_pr | create_bitbucket_data_center_pr |