mcpField
B
bitbucket-helper

bitbucket-helper

github.com/darknesskiller開発0114 回インストール2 週間前に更新
リポジトリ

bitbucket-helper について

bitbucket-helper は、Git リポジトリから Bitbucket のプルリクエストを確認・管理するスキルです。設定済みリモートから Cloud または Server を判別し、レビューや承認を得た変更を支援します。

主な機能

  1. 01Bitbucket 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 ヘルパー

設定済みの 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 の読み取り／書き込み権限を持つアプリパスワード。

リポジトリ検出には SSH クローンのリモートも使用できます。SSH キーで認証できるのは Git の転送のみです。REST API の呼び出しには Bitbucket のユーザー名／トークン認証情報が別途必要です。

検出

リモートタイプ
URL に bitbucket.org が含まれるCloud
host/scm/ または host/projects/Server

上書き：--cloud または --base-url。

コメント

Markdown 対応