用途:在 Bitbucket Cloud 上通过 REST/API 直接访问仓库与拉取请求,凭据由环境变量注入,明确不使用 Bitbucket MCP、mcporter 或连接器工具,除非用户显式覆盖。
主要能力:解析 Bitbucket URL 得到 workspace、repo_slug 和 PR id;读取 PR 详情、评论、活动、diff、diffstat、提交等;也可通过 request 调用自定义端点。
使用方式:先设置目标仓库,如 export BITBUCKET_WORKSPACE=bank-x、export BITBUCKET_REPO_SLUG=mobile-app-workspace。认证二选一:Basic 认证用 BITBUCKET_USERNAME 与 BITBUCKET_API_TOKEN;Bearer 认证用 BITBUCKET_ACCESS_TOKEN。不要将令牌粘贴到对话或硬编码到文件,优先使用已导出的环境变量;缺失时明确指出缺少的变量名。常用读取命令示例:node .../scripts/bitbucket-api.mjs pr 123、comments 123、activity 123、diffstat 123、diff 123 > /private/tmp/bitbucket-pr-123.diff。自定义端点用 request,例如 GET "/repositories/$BITBUCKET_WORKSPACE/$BITBUCKET_REPO_SLUG/pullrequests?state=OPEN&pagelen=50"。大输出保留在 /private/tmp,摘要时给出准确 id、状态、分支名、文件路径或行号。韩语内部工程请求用韩语回答。
限制与护栏:默认只读;变更类方法需用户明确请求且设置 BITBUCKET_API_ALLOW_WRITE=1。API 失败时报告确切 HTTP 状态与响应正文片段;未实际调用 API 不得声称已检查 PR、评论或文件;REST 失败时不要回退到 Bitbucket MCP,应直接说明失败并询问是否尝试其他途径。常见端点包括 PR、comments、activity、diff、diffstat、commits 的 GET 路径。