Skip to main content

Bitbucket

ShanoneのBitbucket連携では、日常的なコードレビューのワークフローをカバーする15個のツールをエージェントに提供します — リポジトリとブランチ、プルリクエスト、課題、コード検索です。

はじめに

1

OAuthで接続する

エージェントにBitbucketで何か作業をしてもらう(例:「my-workspace/my-repoのオープンなプルリクエストを一覧表示して」)か、Shanoneダッシュボードのインテグレーションから事前に接続します。
2

リクエストされたスコープを承認する

Shanoneにアクセスさせたいワークスペースとリポジトリについて、BitbucketのOAuth承認画面で承認します。
3

リクエストを再試行する

接続が完了すると、bitbucket_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。

利用可能なツール

Shanoneは Bitbucket向けに15個のツールを提供しており、以下のカテゴリに分類されています。
bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_create_pull_request, bitbucket_create_pull_request_comment
bitbucket_list_issues, bitbucket_get_issue, bitbucket_create_issue, bitbucket_create_issue_comment
bitbucket_list_repositories, bitbucket_get_repository, bitbucket_list_branches, bitbucket_list_commits
bitbucket_search_code
bitbucket_get_current_user, bitbucket_list_workspaces

よくある使い方

PRレビューのトリアージ

リポジトリ内のオープンなプルリクエストを一覧表示し、対応が必要なものにコメントする

リポジトリ横断のコード検索

ワークスペース内の複数リポジトリをまたいで、関数や文字列の使用箇所を検索する

課題バックログの整理

オープンな課題を一覧表示・コメントし、バックログを最新の状態に保つ

ブランチ/コミットの点検

マージ前に、mainからどれだけ分岐しているかをブランチと直近のコミットで確認する

トラブルシューティング

結果はOAuth時に承認されたワークスペースにスコープされます。bitbucket_list_workspacesでどのワークスペースが接続されているか確認し、不足していれば再接続してください。
Bitbucketのコード検索はプッシュ後に非同期でインデックスされるため、直近のコミットはまだ検索対象になっていない場合があります。すぐに結果が必要な場合は、対象ブランチに対してbitbucket_list_commitsを使ってください。
まずbitbucket_list_branchesでソース・宛先ブランチの名前を確認してください — Bitbucketは両方のブランチがリポジトリに既に存在していることを要求します。