posting-review-summary について
posting-review-summaryは、コードレビューエージェント向けに要約の内容、形式、出力先を定めるスキルです。ローカル、Agent Mode、GitHub Actionsなどの状況に応じて、ファイルまたはGitHubコメントを出力先に選びます。
主な機能
- 01状況に応じた要約の出力先選択
- 02判定と要約の形式指定
- 03重大なPRメタデータ不足の確認
- 04重要度順の指摘事項整理
- 05未レビュー範囲の明記
活用シーン
- 01ローカルコードレビュー結果の要約ファイル保存
- 02Agent Mode後続処理向け要約ファイルの準備
- 03GitHub MCPツールによるレビューコメント更新
MCP 対応
GitHub Actionsのタグモードでは、mcp__github_comment__update_claude_commentを使って固定コメントを更新します。Agent Modeとローカルモードではこのツールを呼び出しません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bitwarden/ ai-plugins --skill posting-review-summaryインストール後、Claude Code で/posting-review-summaryを入力して読み込まれたか確認します。
詳細
投稿レビューの概要
コンテキストの検出
次の順序でコンテキストを確認し、最初に一致したものを使用します。
| コンテキスト | 検出方法 | アクション |
|---|---|---|
| ローカル出力が有効 | プロンプトの先頭の指示ブロックにある OUTPUT: local files の行、または呼び出し元が有効な出力先としてローカルファイルを指定している場合。最初にこれを確認し、使用可能なツールを基準に判断しないでください | 作業ディレクトリの review-summary.md に書き込みます |
| ローカルの対象で、GitHub の出力先がない | レビュー対象がローカルの変更で、呼び出し元が GitHub の出力先を指定していない場合 | 作業ディレクトリの review-summary.md に書き込みます |
| エージェントモード | プロンプトに付与されたスティッキーコメントのコンテキスト(コメント ID + `` マーカー) | 概要を /tmp/review-summary.md に書き込みます |
| GitHub Actions(タグモード) | mcp__github_comment__update_claude_comment が使用可能で、スティッキーコメントのコンテキストがない場合 | MCP ツールでスティッキーコメントを更新します |
| ローカルレビュー | エージェントモードのコンテキストも MCP ツールも使用できない場合 | 作業ディレクトリの review-summary.md に書き込みます |
禁止事項: 概要コメントを作成するために gh pr comment を使用しないでください。
PR メタデータの評価
PR のタイトル、説明、またはテスト計画に明らかな不備がある場合は、「コードレビューの詳細」折りたたみセクションに指摘を追加します。
ルール
- 軽微な改善点についてコメントしないでください
- 十分だが完璧ではないメタデータについてコメントしないでください
- インラインコメントとして追加しないでください
- PR メタデータの評価に関するフィードバックは 3 行を超えないでください
例
明らかな不備とは、次のようなものです:
- タイトルが文字どおり「fix bug」、「update」、「changes」、または単一の単語である
- 説明が空、または「See Jira」だけである
- UI の変更があるのにスクリーンショットが 1 枚もない
- テスト計画がなく、かつ変更がテスト可能である
十分な例(指摘しないでください):
- 完璧ではなくても、変更内容を説明しているタイトル:「SSO ユーザーのログイン問題を修正」
- 変更内容を簡潔にでも説明する説明がある
- テストの詳細とともに Jira タスクを参照するテスト計画がある
形式
- ❓ **QUESTION**: PR title could be more specific
- Suggested: "Fix null check in UserService.getProfile"
概要の形式
## 🤖 Bitwarden Claude Code Review
**Overall Assessment:** APPROVE / REQUEST CHANGES
[Up to 4 neutral sentences describing what was reviewed]
[Optional **Not covered:** line - only when a review step the diff called for did not run and nothing else in this review covered its ground]
<details>
<summary>Code Review Details</summary>
[Findings grouped by severity - see ordering below]
[Optional PR Metadata Assessment - only for truly deficient metadata]
</details>
判定なし
何もレビューされなかった場合、差分を生成できなかった場合、差分が空だった場合、プルリクエストを特定できなかった場合、またはレビューが行われなかったその他の理由がある場合は、上記のテンプレートの代わりにこの形式を使用してください。テンプレート内の3つ目の値として使用するものではありません。APPROVE も REQUEST CHANGES も出力しないでください。レビューされていない差分に対する判定は、判定がないよりも悪いものです。
通常の要約に使用する宛先と同じ場所に出力します。宛先は、上記のコンテキスト検出と、下記の出力の実行にあるモードごとの手順で決まります。エージェントモードではマーカーの追記も含まれます。これがないと、次回の実行時に固定コメントを見つけられず、重複して投稿されます。この形式によって出力先が変わることはありません。何も書き込まずに停止すると、レビューで何も見つからなかったかのように読めるプレースホルダーコメントが残ります。この形式は、それを防ぐためにあります。
理由は、評価文と同じ位置、つまり<details>の外側に記載してください。カバレッジの注記と同じ理由です。展開されない理由は、読まれません。この形式には<details>ブロックを一切含めません。記載すべき指摘事項がないためです。カバレッジの注記も不要です。この形式自体が、レビュー全体が行われなかったことを示しています。
## 🤖 Bitwarden Claude Code Review
**Overall Assessment:** NO VERDICT
[One or two sentences: what was attempted, what stopped it, and what the caller should do next]
対象外
カバレッジの注記は指摘事項ではありません。引用するfile:lineがなく、上記の評価文とは逆に、レビューされなかった内容を示すものです。そのため、承認によって埋もれないよう、<details>ブロックの外側に独立した行として記載します。
差分から必要とされたレビュー手順が実行されず、今回のレビューのほかの部分でもその対象をカバーできなかった場合に表示してください。そのレビュー担当に到達する経路がない場合や、レビュー担当でエラーが発生した場合、または利用可能な結果が返されなかった場合が該当します。利用できなかっただけの任意の補強スキルは該当しません。その場合は既存のレビュー知識で補えるため、対象はカバーされています。未レビューのファイル、その理由、およびそれらをカバーする別の経路を明記してください。実際に該当する理由を記載してください。確認できないインストール状態を断定したり、記載した理由によっても妨げられる解決策を示したりしないでください。
例として、Taskが利用できないため、インストール状態にかかわらずplugin-dev:skill-reviewerを起動できないbitwarden-code-reviewerの経路を示します。
**Not covered:** Skill review did not run — this review path cannot launch
`plugin-dev:skill-reviewer`, so `plugins/example/skills/doing-a-thing/SKILL.md` was not checked
for description quality, length, or progressive disclosure.
`performing-multi-agent-code-review` covers them where `plugin-dev` is installed.
差分から必要とされたすべてのレビュー手順が実行された場合は、この行全体を省略してください。未レビューの内容を隠した承認は、その内容も問題なしと判断されたように読めます。
依存関係の変更テーブル
PRの差分に依存関係マニフェストファイルの変更が含まれる場合は、<details>ブロック内で、指摘事項の一覧の後、任意のPRメタデータ評価の前に、依存関係の変更サブセクションを追加してください。
**意味のあるバージョン変更がある場合に限り、このテーブルを表示してください。**マニフェストに変更がなく、ロックファイルだけが変わった場合は表示しません。
### Dependency Changes
| Package | Change | Ecosystem |
| ----------------- | --------------------- | --------- |
| `@foo/bar` | New (1.2.0) | npm |
| `lodash` | 3.x → 4.x (**major**) | npm |
| `Newtonsoft.Json` | 13.0.1 → 13.0.3 | NuGet |
| `old-package` | Removed | npm |
メジャーバージョンの更新では、「major」の単語を太字にしてください。追加は「New (version)」、削除は「Removed」と記載します。
Details セクション内の指摘事項
**並び順:**指摘事項は、重大度ごとに次の順序でまとめてください。
- ❌ : CRITICAL
- ⚠️ : IMPORTANT
- ♻️ : DEBT
- 🎨 : SUGGESTED
- ❓ : QUESTION
該当する指摘事項がないカテゴリは省略してください。
指摘事項ごとの形式:
- [emoji]: [One-line description]
- `filename.ts:42`
例:
<details>
<summary>Code Review Details</summary>
- ❌ : SQL injection in user query builder
- `src/auth/queries.ts:87`
- ⚠️ : Missing null check on optional config
- `src/config/loader.ts:23`
</details>
出力の実行
エージェントモード(固定コメント)
プロンプトに固定コメントのコンテキスト(コメントID+マーカー)が指定されている場合:
- Writeツールを使って、要約を
/tmp/review-summary.mdに書き込みます - ファイルの内容の末尾に
\n\nを追加します mcp__github_comment__update_claude_commentは使用しないでくださいgh pr commentやgh apiは使用しないでください
ワークフローの後処理でこのファイルを読み込み、プレースホルダーコメントを自動的に更新します。
GitHub Actions(タグモード)
Use mcp__github_comment__update_claude_comment to update the sticky comment with the summary.
ローカル
Write summary to review-summary.md in working directory.