关于 bitbucket-helper
bitbucket-helper 是用于从 Git 仓库检查和管理 Bitbucket 拉取请求的技能。它根据配置的远程地址识别 Bitbucket Cloud 或 Server,并支持审查及经授权的更改。
主要功能
- 01识别 Bitbucket Cloud 或 Server
- 02列出并读取拉取请求
- 03提供审查上下文和差异
- 04创建、更新和批准拉取请求
适用场景
- 01审查当前仓库的拉取请求
- 02检查变更文件和指定差异
- 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
步骤
- 不带参数运行辅助脚本,以检测类型和 PR 上下文。源、目标、项目和仓库均已确定时即完成。
- 需要 PR 正文时:先使用
/pr-writing。正文包含 Description、Test Plan、Test Result、Links 时即完成。 - 在实际创建、更新或批准之前:先确认,除非用户已明确提出要求。
- 进行审查时:先运行
review-context,再使用diff --path或file查看指定内容。 - 更新时:先读取 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.org | Cloud |
host/scm/ 或 host/projects/ | Server |
覆盖方式:--cloud 或 --base-url。
评论
支持 Markdown