mcpField
P
posting-bitwarden-review-comments

posting-bitwarden-review-comments

github.com/bitwardenテスト・品質16290 回インストール今日更新
リポジトリ

posting-bitwarden-review-comments について

Bitwarden のコードレビューで見つかった内容を、ローカルの Markdown ファイルまたは GitHub のプルリクエストに記録するスキルです。コメント形式とスレッド返信の規則を定めています。

主な機能

  1. 01ローカルまたは GitHub の出力先を判定
  2. 02ローカルの内容を単一の Markdown ファイルに保存
  3. 03既存の GitHub スレッドに返信
  4. 04簡潔な番号付き形式で内容を記述

活用シーン

  1. 01ローカルコードレビューの内容を保存
  2. 02GitHub のプルリクエストに内容を投稿
  3. 03重複する内容を既存スレッドに集約

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bitwarden/ai-plugins --skill posting-bitwarden-review-comments

インストール後、Claude Code で/posting-bitwarden-review-commentsを入力して読み込まれたか確認します。

詳細

Bitwarden レビューコメントの投稿

投稿先の検出

この順序で投稿先を確認し、最初に一致したものを使用します。

投稿先検出方法アクション
ローカル出力が有効プロンプトの先頭の指示ブロックに OUTPUT: local files の行がある、または呼び出し元が有効な投稿先としてローカルファイルを渡している。まずこれを確認し、利用可能なツールに基づいて判断しないでください作業ディレクトリの review-inline-comments.md に書き込みます
ローカルの対象で、GitHub の投稿先なしレビュー対象がローカルの変更で、呼び出し元が GitHub の投稿先を指定していない作業ディレクトリの review-inline-comments.md に書き込みます
GitHub プルリクエスト上記のいずれにも該当しないmcp__github_inline_comment__create_inline_comment を使って投稿します

ローカルの投稿先では、以下の形式で各指摘を正確に記載し、ソース行は含めず、すべてを1つのファイルに書き込みます。利用可能なコメントツールにかかわらず、投稿してはいけません。

GitHub プルリクエストでは、既存のスレッドで再度指摘する場合、そのスレッドへの返信として投稿し、履歴が1か所にまとまるようにします。スレッドの最初のコメントの database_id を commentId として、スレッドデータのトップレベルにある repository から所有者とリポジトリを指定し、返信に本文がある場合にツールが必要とするプルリクエスト番号を pullNumber として、mcp__github_replies__add_reply_to_pull_request_comment を呼び出します。返信にはインラインコメントと同じ指摘形式を使用します。このツールを利用できない場合、スレッドの最初のコメントに database_id がない場合、または返信の呼び出しに失敗した場合は、新しいインラインコメントを投稿します。

コメント投稿プロトコル

  1. 必須：何かを出力する前に、すべての変更を分析してください
  2. 必須：コード固有の指摘にはインラインコメントを使用してください
  3. 必須：Bitwarden の指摘形式を使用してください
  4. 禁止：「強み」「ハイライト」や肯定的な所見のセクションを追加しないでください
  5. 禁止：称賛のみのインラインコメントを投稿しないでください
  6. 禁止：PR のメタデータに関する問題（タイトル、説明、テスト計画）をインラインコメントとして投稿しないでください。これらは要約のみに記載します。

指摘の形式

重要：# の後に数字を付けないでください。GitHub が無関係な Issue／PR へのリンクを自動生成します。

  1. 「#1」と書くと、指摘ではなく Issue／PR の #1 へのクリック可能なリンクが作成されます
  2. 「Issue」も誤った用語です（「Finding」を使用してください）
  3. 「Finding」の後にスペースと番号を付けます（# 記号は付けません）。文は30語未満を目安にしてください

正しい形式：

  • Finding 1: メモリリークを検出
  • Finding 2: エラー処理が不足

誤った形式（使用しないでください）：

  • ❌ Issue #1（用語が誤りで、自動リンクされます）
  • ❌ #1（自動リンクのみ）
  • ❌ Issue 1（用語のみ誤り）

インラインコメント

すべてのインラインコメントでは、必ず次のことを行ってください。

  1. 該当する行を明記する
  2. 問題点を説明する — 何が壊れるのか、またはどのようなリスクがあるのか
  3. 実行可能な修正方法を示す（❌ と ⚠️ の場合）
  4. 簡潔かつ明確にする
  5. 5行を超えるコメントには折りたたみセクションを使用する
  6. 開始タグ <details> と終了タグ </details> の両方を含める
  7. GitHub のプルリクエストでは、短いコメントやスレッドへの返信も含め、最後にソース行 <sub>code-review</sub> を記載する

表示ルール： 重要度と1行の説明のみを表示し、GitHub のプルリクエストではソース行も表示します。それ以外はすべて <details> タグ内に記載してください。

長いコメントのテンプレート
[emoji] **[SEVERITY]**: [One-line issue description]

<details>
<summary>Details and fix</summary>

[Code example or specific fix]

[Rationale explaining why]

Reference: [docs link if applicable]
</details>

<sub>code-review</sub>

サマリー出力

サマリーの書式設定と投稿には、すべて Skill(posting-review-summary) を呼び出してください。

コメント

Markdown 対応