mcpField
C
code-review-html

code-review-html

github.com/channテスト・品質039 回インストール3 週間前に更新
リポジトリ

code-review-html について

code-reviewスキルの派生版で、MarkdownレポートとインタラクティブなHTMLレポートを生成します。HTMLは韓国語と英語に対応し、指摘ごとのコメント、Markdownのコピー、フィードバック生成ができます。

主な機能

  1. 01MarkdownとインタラクティブHTMLを生成
  2. 02韓国語と英語を切り替え
  3. 03重大度バッジとシンタックスハイライト
  4. 04ライト・ダーク・コード配色を選択
  5. 05折りたたみ式サイドバーと指摘ごとのコメント
  6. 06指摘またはフィードバックをコピー

活用シーン

  1. 01二言語HTMLでコードレビュー結果を読む
  2. 02ブラウザーで指摘にコメントする
  3. 03指摘やフィードバックをコピーして修正に活用

インストール

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

$npx skills add https://github.com/chann/skills --skill code-review-html

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

詳細

コードレビュー（HTML レポート）

概要

code-review スキルのバリエーションで、Markdown レポートと自己完結型のインタラクティブな HTML レポートを生成します。

HTML レポートはバイリンガル（韓国語＋英語、ページ全体の言語切り替え機能付き。デフォルトでは韓国語を表示）で、重要度バッジ、ライト／ダーク／自動テーマと 8 種類のコードスキームセレクターに対応した構文ハイライト、折りたたみやサイズ変更が可能なコンパクトなサイドバー、各指摘事項の「Markdown をコピー」、ブラウザーに保存される各指摘事項へのコメント、レビューを洗練させるための再生成用ペイロードを出力する「フィードバックをコピー」ボタンを備えています。

ワークフロー

開始する前に、メインの code-review の SKILL.md を読みます。場所は <plugin-root>/skills/code-review/SKILL.md です。レビュー手順、重要度テーブル、言語の参照マッピング、レポートの Markdown テンプレートはすべてここに記載されています。このバリエーションは、これらのセクションに依存します。

メインスキルのエビデンス優先の記述契約と条件付きセクションのルールが優先されます。ここでそれらを言い換えたり、緩和したりしないでください。

その後、メインの SKILL.md にあるレビュー手順に正確に従います。手順 1～6 はすべて適用され、HTML の生成も含まれます。

要約すると、次のとおりです。

  1. レビューの対象範囲を決定し、該当する git diff を実行します（メインの SKILL.md の「レビュー対象範囲の決定」を参照）。

  2. diff_stats.py を実行し、該当言語の参照資料と、必要に応じて common-vulnerabilities.md を読み込みます。

  3. 5 つの観点で diff を分析し、重要度を割り当てます。各指摘事項には一意で安定した [CR-001] 形式の ID を付けます。

  4. 構造が同一の Markdown ファイルを2 つ作成します（ID とコードブロックも同一にします）。

    • .reviews/<YYYY-MM-DD>_<short-sha>.md — 韓国語、**Language:** ko（メインレポート）。
    • .reviews/<YYYY-MM-DD>_<short-sha>.en.md — 英語、**Language:** en。

    メインスキルのエビデンス優先の記述契約に従い、パーサーが重要視する英語のメタデータキーを維持します。

  5. python <skill-path>/scripts/generate_html_report.py .reviews/<report>.md を実行します（.en.md の同階層ファイルを自動検出し、両方を 1 つの HTML に統合します）。その後、open を実行します。

  6. この永続化 HTML モードでは、重要度ごとの指摘件数、全体的なリスク、Markdown および HTML の成果物パス、最新の検証結果、ブラウザーで開いた事実または警告のみを含む、事実に基づいた引き継ぎを行います。レポートの本文を繰り返したり、指摘件数を固定して約束したりしないでください。

成果物を生成し、かつ .reviews/ が無視対象になっていない場合に限り、この引き継ぎに .reviews/ を無視対象にする提案を含めます。.gitignore は自動変更しないでください。

スクリプトは <plugin-root>/skills/code-review/scripts/generate_html_report.py にあります（メインスキルに含まれており、バリエーション間で共有されています）。

ファイル名

  • .reviews/<YYYY-MM-DD>_<short-sha>.md — 韓国語レポート（メイン）
  • .reviews/<YYYY-MM-DD>_<short-sha>.en.md — 英語レポート（翻訳）
  • .reviews/<YYYY-MM-DD>_<short-sha>.html — 統合されたバイリンガル HTML

メインの SKILL.md の「クイックリファレンス／ファイル名の規則」を参照してください。

言語

デフォルトではバイリンガルです。韓国語と英語の両方を記述します（メインの SKILL.md の「バイリンガル HTML レポート」を参照）。生成スクリプトが正しくラベル付けして切り替えられるよう、各ファイルのヘッダーに **Language:** ko／en を設定し、読者が言語を切り替えても各指摘事項へのコメントが引き継がれるよう、2 つのファイルで指摘 ID を同一に保ちます。ユーザーが 1 つの言語だけを明示的に求めた場合は、その言語のファイルのみを作成します。生成スクリプトは単一言語のレポートに切り替え機能を表示せずに対応します。

危険信号

メインの <plugin-root>/skills/code-review/SKILL.md にある Never／Always リストと同じです。特に、.gitignore は自動変更せず、提案のみにすること、diff の範囲外のコードにはコメントしないことを徹底してください。

統合

連携先： git-commit — 最終的な品質確認として、コミット前にレビューします。

コメント

Markdown 対応