mcpField
B
bitbucket-helper

bitbucket-helper

github.com/darknesskiller开发0114 次安装2 周前更新
代码仓库

关于 bitbucket-helper

bitbucket-helper 是用于从 Git 仓库检查和管理 Bitbucket 拉取请求的技能。它根据配置的远程地址识别 Bitbucket Cloud 或 Server,并支持审查及经授权的更改。

主要功能

  1. 01识别 Bitbucket Cloud 或 Server
  2. 02列出并读取拉取请求
  3. 03提供审查上下文和差异
  4. 04创建、更新和批准拉取请求

适用场景

  1. 01审查当前仓库的拉取请求
  2. 02检查变更文件和指定差异
  3. 03获授权后更新拉取请求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/darknesskiller/skills --skill bitbucket-helper

安装后在 Claude Code 中输入/bitbucket-helper确认已加载。

附带文件agents/openai.yamlscripts/bitbucket_server_pr.py

详细介绍

Bitbucket Helper

根据配置的 git 远程仓库自动检测 Bitbucket Cloud 或 Server。

辅助脚本位于相对于此技能目录的 scripts/bitbucket_server_pr.py(由运行环境解析)。从用户的仓库中使用脚本的绝对路径或相对于技能目录的路径运行:

python3 <skill-dir>/scripts/bitbucket_server_pr.py

步骤

  1. 不带参数运行辅助脚本,以检测类型和 PR 上下文。源、目标、项目和仓库均已确定时即完成。
  2. 需要 PR 正文时:先使用 /pr-writing。正文包含 Description、Test Plan、Test Result、Links 时即完成。
  3. 在实际创建、更新或批准之前:先确认,除非用户已明确提出要求。
  4. 进行审查时:先运行 review-context,再使用 diff --path 或 file 查看指定内容。
  5. 更新时:先读取 PR 版本,仅发送可修改字段(title、description、version、fromRef、toRef、reviewers)。绝不要发送 author。

完成条件:操作范围限定为已检测到的仓库和 PR,且变更已获授权。

命令

# Read
list --repo-dir . [--state OPEN] [--limit 25] [--page-start 0]
get <pr_id> --repo-dir . [--body]
review-context <pr_id> --repo-dir .
files <pr_id> --repo-dir .
diff <pr_id> --repo-dir . --path <path>
file <path> --repo-dir . --at refs/heads/main
commits <pr_id> --repo-dir .
commit <sha> --repo-dir .

# Mutate
approve <pr_id> --repo-dir .
create --repo-dir . --target main --title "PROJ-123: title" [--draft]
update <pr_id> --repo-dir . [--refresh-description | --ready]

标志:--full、--body、--format text、--cloud、--base-url。

身份验证

BB_USER / BB_PASSWORD 或限定范围的 BB_CLOUD_* / BB_SERVER_*(限定范围的凭据优先)。Cloud:使用具有 Repositories 和 Pull Requests 读写权限的 App Password。

支持通过 SSH 克隆远程仓库来检测仓库。SSH 密钥仅用于 Git 传输身份验证;REST API 调用仍需要 Bitbucket 用户/令牌凭据。

检测

远程仓库类型
URL 中包含 bitbucket.orgCloud
host/scm/ 或 host/projects/Server

覆盖方式:--cloud 或 --base-url。

评论

支持 Markdown