omc-review について
omc-review は、既存の変更を評価するワークフローで、審査対象の変更は作成しません。指摘候補を検証して重大度順に報告し、確認範囲と評価できなかった点も示します。
主な機能
- 01変更内容と意図を把握
- 02正確性とリスクを優先して確認
- 03指摘候補を検証してから報告
- 04重大度順に指摘を整理
- 05大規模な変更を規約と意図の軸で分けて審査
活用シーン
- 01完了したコード変更のレビュー
- 02セキュリティ境界とデータ整合性リスクの確認
- 03要件への適合とテスト範囲の評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill omc-reviewインストール後、Claude Code で/omc-reviewを入力して読み込まれたか確認します。
詳細
レビュー
既存の成果物を評価する際に、このスキルを使用します。レビューでは、評価対象の変更を作成しません。
これが標準のレビュー手順です。ai-slop-cleaner は、その中のオプトイン方式のレーンです。
目標
実際の問題を深刻度順に特定し、対処できるだけの詳細を示します。
ワークフロー
- 何が変更され、その変更が何を目的としていたかを確認します。
- その意図に照らして変更内容を読みます。
- まず正確性を確認し、次にリスク、最後に簡素化を確認します。
- 報告する前に、候補となる指摘をそれぞれ検証します。
- 深刻度の高い指摘から順に報告します。
確認項目
- 正確性 — ロジックの欠陥、エッジケース、エラー経路、並行処理
- リスク — セキュリティ境界、破壊的な操作、データの整合性
- 再利用 — 変更で使用すべき既存のユーティリティやパターン
- 簡素化 — 削除またはまとめられるコード
- テスト範囲 — テストされていないままリリースされる動作
2 つの軸で別々に実施
大規模な差分は、2 つの並行するサブエージェントによるレビューとして実施し、結果を別々に報告します。変更が一方の軸では合格し、もう一方では不合格になることもあるため、統合したり、軸をまたいで順位付けしたりしてはいけません(規約には準拠していても動作が誤っている場合や、意図には忠実でも慣例に反している場合があります)。
- 規約の軸 — リポジトリで文書化されている規約と、判断を要するものに限ったコードスメルの基準に照らして差分を確認します。ツールで既に強制されている項目は対象外です。規約は推測せず、リポジトリから特定します。規約文書(CLAUDE.md/AGENTS.md、
docs/standards/内の各文書、CONTRIBUTING.md、CODING_STANDARDS.mdなど)を検索し、存在するものすべてを基準にレビューします。確認していない規約ファイルがあるなら、その規約は適用されていません。 - 意図の軸 — 作業の目的(タスク、仕様、チケットの受け入れ条件)に照らして差分を確認します。不足している要件や一部しか満たされていない要件、誰も求めていない動作を指摘し、各指摘には根拠となる記述の行を引用します。
各サブエージェントへの指示は約 400 語以内にまとめ、対象の軸だけに絞ります。結果を集約する際、どちらか一方を勝者として選んではいけません。軸を分けているのは、再順位付けを避けるためです。各軸の判定はそれぞれ独立して示します。差分が小さい場合は、1 回のレビューで十分です。
ルール
- レーンを分けます。レビュアーは、作成者と同じアクティブなコンテキストを使ってはいけません。
- 報告前に検証します。もっともらしく聞こえても再現しない指摘はノイズです。
- 深刻度は正直に示します。網羅的に見せるために指摘を水増ししてはいけません。
- 問題がないという結果も有効です。
- 原則として助言を目的とします。レビューは判断材料であり、承認の可否を決めるものではありません。リリース、セキュリティ、破壊的な操作に関する厳格なゲートは別に設け、フェイルクローズにします。
出力
- 深刻度の高い順に、ファイル、行番号、具体的な失敗シナリオを添えた指摘
- 確認して問題がなかった項目
- 評価できなかった項目
コメント
Markdown 対応