（3838期）Snowsand Bitbucket – Bitbucket 云端代码协作中枢

Bitbucket 云端代码协作中枢 基于 Bitbucket Cloud REST API v2 的官方集成方案，支持仓库管理、PR 全生命周期、分支操作与 CI/CD 流水线监控，为团队提供企业级 Git 工作流自动化能力。 使用说明 核心用法 本 Skill 通过封装 Bitbucket Cloud REST API v2，提供完整的命令行工具链 bitbucket.py，覆盖代码托管的核心场景： 仓库管理：支持列表查询、详情查看、公私仓创建及项目关联，满足团队代码资产的基础管理需求。 Pull Request 工作流：这是该 Skill 最完整的模块，涵盖 PR 的创建、查看、评论、审批（approve/unapprove/request-changes）、合并（支持 mergecommit/squash/fastforward 三种策略）及拒绝操作，几乎复刻了 Web 端的完整评审体验。 分支与提交：支持分支的创建（基于分支或指定 commit）、删除、列表查询，以及提交历史的追溯与详情查看，便于代码审计与版本回溯。 CI/CD 集成：可查询流水线状态（PENDING/IN_PROGRESS/SUCCESSFUL/FAILED/STOPPED）、查看步骤详情，甚至触发新构建，实现 DevOps 流程的无缝衔接。 工作空间治理：支持多工作空间切换、成员查询及当前用户身份确认，适配企业多租户架构。 显著优点 企业级认证体系：同时支持 Atlassian API Token（推荐）与 Legacy App Password，兼顾安全性与兼容性，明确区分 email/username 的配对规则，降低配置出错率。 工作流闭环设计：PR 模块覆盖从创建到合并的完整生命周期，特别是 request-changes 等细粒度状态，优于多数简易 API 封装工具。 DevOps 原生集成：内置 Pipeline 查询与触发能力，可直接对接 Bitbucket Pipelines，减少跨平台切换成本。 灵活的认证隔离：通过环境变量注入凭证，支持 SnowSand Vault 等企业密钥管理系统，避免硬编码风险。 分页与过滤友好：多数列表操作支持 --page、--pagelen 及状态过滤（如 --status SUCCESSFUL），适配大规模仓库场景。 潜在缺点与局限性 Bitbucket Cloud 独占：明确基于 Bitbucket Cloud REST API v2，不支持 Bitbucket Server/Data Center（后者 API 路径与认证机制不同），企业私有化部署场景受限。 变更适配风险：文档提及 CHANGE-2770 导致的 API 废弃（HTTP 410），说明 Atlassian 的 API 演进可能带来破坏性变更，需持续关注兼容性。 功能边界依赖脚本：超出封装范围的操作需回退到 curl 原始请求，对非 API 专家不够友好。 权限粒度粗：App Password 的权限范围较宽（Repositories: Read/Write 等），无法精细控制到单个仓库或操作类型，需配合工作空间隔离使用。 无 Webhook 支持：仅为单向 API 调用，无法实现事件驱动（如 PR 创建自动通知），需额外搭建事件体系。 适合的目标群体 中小型技术团队：已采用 Bitbucket Cloud 作为代码托管平台，需要 CLI 工具提升日常操作效率。 DevOps/平台工程师：需要自动化流水线状态监控、批量 PR 管理或 CI/CD 集成脚本编写。 全栈开发者：偏好命令行工作流，希望在不离开终端的情况下完成代码评审与分支管理。 企业 IT 管理员：需要批量查询工作空间成员、审计仓库配置或执行合规性检查。 使用风险 凭证泄露风险：BITBUCKETAPPPASSWORD 虽名为 App Password，实际可存放高权限的 Atlassian API Token，一旦环境变量泄露将导致工作空间级访问失控，必须配合密钥管理系统使用。 误操作不可逆：delete-branch、decline、merge 等操作直接作用于生产仓库，脚本缺乏交互确认机制，建议在 CI/CD 场景中配套审批卡点。 API 限流与稳定性：Atlassian Cloud API 存在速率限制，大规模批量操作（如遍历全组织提交历史）可能触发限流，需实现指数退避重试。 网络可达性依赖：国内访问 Atlassian Cloud 可能存在延迟或间歇性连接问题，关键自动化流程需评估网络可靠性。 版本锁定风险：bitbucket.py 作为外部脚本依赖，其更新与 Skill 版本可能存在滞后，建议监控上游变更并建立内部 Fork 机制。 原始说明 Interact with Bitbucket Cloud via REST API. Use for repository management, pull request operations (list, view, create, comment, approve, merge), branch mana...