From knowledge-plugin
アーキテクチャレビュー結果を意思決定用レポートに整形する。チャット報告・ファイル出力・GitHub Issue作成から出力形式を選択可能。「レビューレポートを作成して」「報告書を生成して」「意思決定用にまとめて」「Issueにして」と言われた時に使用。
How this skill is triggered — by the user, by Claude, or both
Slash command
/knowledge-plugin:review-report-generatorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
レビュー結果を意思決定に耐える形式のレポートに整形する。
レビュー結果を意思決定に耐える形式のレポートに整形する。
核心: 網羅的な指摘より「意思決定に必要な形」を優先する。
必須:
architecture-review/*/review.yaml - architecture-reviewer の統合出力(findings + conflicts + prioritized_actions)推奨:
system-map/invariants.yaml - 不変条件$ARGUMENTS で出力形式を決定する。未指定の場合は chat をデフォルトにする。
| 値 | 動作 | 用途 |
|---|---|---|
chat | チャットで直接報告 | 素早い確認、口頭報告の下書き |
file | ファイル群を生成 | チーム共有、ドキュメント保存 |
issue | GitHub Issueを作成 | バックログ追加、タスク管理 |
判定ロジック:
$ARGUMENTS が file なら file 形式で出力する$ARGUMENTS が issue なら issue 形式で出力するchat・不明な値)は chat 形式で出力するチャットにMarkdownで直接報告する。ファイルは生成しない。
# アーキテクチャレビュー報告書
**レビュー日**: 2024-01-21
**対象**: order-service, payment-service, inventory-service
## サマリー
| カテゴリ | 件数 | 対応状況 |
|---------|------|---------|
| P0 (Blocker) | 2 | 即時対応必須 |
| P1 (Critical) | 3 | 今スプリント |
| P2 (High) | 5 | 次スプリント |
| P3/P4 | 8 | バックログ |
P0/P1の各指摘には以下を含める:
architecture-review/{timestamp}/report/ 配下にファイル群を生成する。
architecture-review/{timestamp}/
├── review.yaml # architecture-reviewer の統合出力(既存)
└── report/ # 本スキルの出力
├── summary.md # エグゼクティブサマリー
├── p0-blockers.md # P0詳細(全フィールド)
├── p1-critical.md # P1詳細(全フィールド)
├── p2-high.md # P2詳細
├── backlog.md # P3/P4
└── adrs-needed.md # 必要なADR一覧
| ファイル | 内容 |
|---|---|
| summary.md | 件数テーブル + P0/P1の1行サマリー + 推奨アクション |
| p0-blockers.md | P0の全指摘。問題・根拠・対応案・PR分割・受け入れ条件 |
| p1-critical.md | P1の全指摘。p0-blockers.md と同形式 |
| p2-high.md | P2の全指摘。対応案は推奨のみ記載 |
| backlog.md | P3/P4。タイトル・スコープ・推奨案・工数の一覧表 |
| adrs-needed.md | ADRが必要な指摘のリスト。トピック・関連指摘・背景 |
| 用途 | 使うファイル |
|---|---|
| ステークホルダー報告 | summary.md のみ |
| 開発チーム共有 | 全ファイル |
| PR作成 | p0-blockers.md + PR分割情報 |
| バックログ追加 | backlog.md をIssue化 |
gh issue create で指摘をGitHub Issueとして作成する。
| 優先度 | Issue数 | ラベル |
|---|---|---|
| P0 | 指摘ごとに1つ | architecture-review, P0-blocker |
| P1 | 指摘ごとに1つ | architecture-review, P1-critical |
| P2以下 | まとめて1つ | architecture-review |
各Issueに以下を含める:
[{priority}] {title}詳細なテンプレートは references/issue-template.md を参照。Issue本文のフォーマットとghコマンド例が記載されている。
1つのIssueに全P2以下の指摘をまとめる:
[Architecture Review] P2以下の指摘事項まとめ({件数}件)gh issue create を実行する各指摘は以下のフィールドを持つ。詳細なYAML例は references/finding-format.md を参照。各フィールドの選択基準や算出方法が記載されている。
| フィールド | 必須 | 内容 |
|---|---|---|
| id | Yes | FINDING-001 形式の一意ID |
| title | Yes | 問題の端的な名称 |
| scope.type | Yes | component / interaction / crosscutting |
| scope.affected | Yes | 影響を受けるコンポーネント |
| failure_mode.description | Yes | 何が成立しなくなるか |
| failure_mode.impact | Yes | ユーザー・ビジネス・システムへの影響 |
| trigger_conditions | Yes | 発生条件のリスト |
| evidence | Yes | 根拠(source, field, value) |
| options | Yes | 対応案のリスト(id, action, pros, cons, effort) |
| priority.category | Yes | P0 / P1 / P2 / P3 / P4 |
| priority.score | Yes | severity x likelihood x detectability x quality_weight |
| priority.rationale | Yes | 優先度判断の理由 |
| implementation.recommended_option | Yes | 推奨する対応案のID |
| implementation.pr_breakdown | Yes | PR分割(タイトル, スコープ, サイズ) |
| implementation.adr_needed | Yes | ADR作成要否 |
| acceptance_criteria.tests | Yes | テスト条件 |
| acceptance_criteria.metrics | No | 定量メトリクス |
| acceptance_criteria.logs | No | ログ確認項目 |
| acceptance_criteria.contract | No | API契約の変更 |
architecture-review, P0-blocker, P1-critical ラベルが存在しない場合は gh label create で作成するnpx claudepluginhub caphtech/claude-marketplace --plugin knowledge-pluginFormats final review deliverables into consistent structures like review reports, PR descriptions, release notes, and incident reports for stakeholder presentation.
Orchestrates parallel reviews from all architecture specialist subagents, aggregates into consolidated report for full multi-perspective assessments.
Lead effective architecture reviews. Manage discussions, surface disagreements, build consensus, document decisions. Use when conducting reviews or running architecture forums.