code-review-md について
レビュー結果を Markdown レポートとして保存し、HTML生成やブラウザー起動を行わない `code-review` スキルの派生版です。主スキルのレビュー規則に従い、コミット前に記録を残すワークフロー向けです。
主な機能
- 01`.reviews/` に Markdown レポートを保存
- 02主スキルのレビュー手順に準拠
- 03HTML生成を省略
- 04引き継ぎに重要度別の件数を記載
活用シーン
- 01コミット前の差分レビュー
- 02レビュー結果をリポジトリに保存
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/code-review-mdを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlevals/evals.json
詳細
コードレビュー（Markdown レポート）
概要
code-review スキルの派生版です。HTML レポートの作成やブラウザーの起動は行わず、指摘事項を .reviews/<YYYY-MM-DD>_<short-sha>.md のみに保存します。
ワークフロー
開始前に、メインの code-review SKILL.md を読み込んでください。場所は <plugin-root>/skills/code-review/SKILL.md です。レビュー手順、重要度の表、言語参照の対応表、レポートの Markdown テンプレートはすべてそこに記載されています。この派生版はそれらのセクションに依存します。
メインスキルの 証拠優先の記述規約 と条件付きセクションのルールが優先されます。ここでそれらを言い換えたり、緩和したりしないでください。
その後、メインの SKILL.md にある レビュー手順 に正確に従ってください。手順 1～4（コンテキストの収集、参照資料の読み込み、分析、レポートの作成）と手順 6（引き継ぎ）を実行します。手順 5（HTML）はスキップしてください。
要約すると、次のとおりです。
- レビュー範囲を特定し、該当する
git diffを実行します（メインの SKILL.md の「レビュー範囲の特定」を参照してください）。 diff_stats.pyを実行し、言語に関連する参照資料を読み込みます。セキュリティ上重要な場合はcommon-vulnerabilities.mdも読み込みます。- 差分を 5 つの観点から分析し、重要度を割り当てます。
- Markdown を永続化するこのモードでは、
.reviews/が存在しない場合は作成し、メインの SKILL.md の Markdown テンプレート（「Markdown レポートの作成」）を使ってレポートを記述します。 - 重要度ごとの指摘件数、全体的なリスク、Markdown 成果物のパス、新たに確認した内容を含む、事実のみの引き継ぎを行います。レポートの文章を繰り返したり、指摘件数を確約したりしないでください。
成果物が生成され、.reviews/ が無視対象になっていない場合に限り、この引き継ぎに .reviews/ を無視対象に追加する提案を含めてください。.gitignore は自動的に変更しないでください。
ファイル名
.reviews/<YYYY-MM-DD>_<short-sha>.md — メインの SKILL.md の「クイックリファレンス／ファイル名の規則」を参照してください。
言語
ユーザーのプロンプトの言語に合わせてください。メインの SKILL.md の「レポート言語」を参照してください。パーサー上重要な英語のメタデータキーはそのまま維持し、メタデータヘッダーに **Language:** <bcp47> を追加してください。
注意事項
メインの <plugin-root>/skills/code-review/SKILL.md と同じ「絶対にしないこと／必ず行うこと」のリストに従ってください。特に、.gitignore は自動的に変更せず（提案のみ）、差分の外にあるコードにはコメントせず、不確実性や称賛に INFO を使わないでください。
統合
連携先： git-commit — 最終的な品質チェックとして、コミット前にレビューします。