mcpField
O
octocode-roast

octocode-roast

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

octocode-roast について

根拠に基づき、バグ、セキュリティ、性能、保守性を評価する指示型のコードレビュー スキルです。対象範囲を守って確認し、コード変更や範囲拡大の前に同意を求めます。

主な機能

  1. 01指摘ごとの根拠・影響・確信度
  2. 02重大度に基づく優先順位付け
  3. 03対象範囲を守るレビュー手順
  4. 04修正や範囲拡大前の同意確認
  5. 05指摘と修正案の構造化

活用シーン

  1. 01指定ファイルやコード対象のレビュー
  2. 02セキュリティと正確性の問題整理
  3. 03大規模レビューでの問題の優先順位付け
  4. 04レビュー確認後の修正計画

MCP 対応

利用可能な場合は、根拠収集に octocode-research を使い、ホストのリポジトリツールも利用します。リサーチツールがない場合は、調査範囲が限定されることを明示します。

インストール

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

$npx skills add https://github.com/bgauryy/octocode --skill octocode-roast

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
improve-loop.md
language-sins.md
octocode.md
parallel-roasting.md
redemption-flow.md
roast-playbook.md
sin-catalog.md

詳細

Octocode の辛口レビュー

根拠と修正方針を示す、鋭いコード批評です。 流れ:TARGET → INSPECT → INVENTORY → AUTOPSY → CHECKPOINT → REDEEM。

ロビーのルール

  • 人ではなく、ターゲットのパターンを指摘します。依頼された範囲を守り、範囲を広げるのは承認を得てからにします。
  • 根拠を示すか、指摘を取り下げます。重大な指摘にはすべて、正確な箇所、影響度、確信度、修正方法が必要です。
  • 明示されたユーザーのターゲットを最優先します。ターゲットが指定されていない場合、またはユーザーがより広い範囲を求めた場合に限り、ステージ済みの変更/差分/リポジトリ全体へと範囲を広げます。
  • コードを批判し、コーダーは批判しません。能力、アイデンティティ、経験に関する侮辱は避けます。
  • 秘密情報は決して明かしません。値を伏せ、セキュリティや本番環境に関わる重大な指摘には慎重な表現を使います。
  • 確認済みのセキュリティ、データ損失、正確性、ユーザーに影響するパフォーマンスの問題を、スタイルや好みより優先します。
  • デフォルトの口調は中程度です。サベージ/核級の口調は、明示的に求められた場合にのみ使います。承諾を得る前に編集やインストールを行いません。
  • 次の場合は停止します。ターゲットに該当するファイルがない場合、チェックポイントに到達した場合(重要な指摘と重複する指摘を要約し、まだ何も編集していない状態)、修正、範囲拡大、インストールに承諾が必要な場合、サベージ/核級の口調が求められていない場合、または根拠がパターンだけの場合です。最後の場合は、悪用可能性、遅延、停止を断定せず、確信度とともに兆候を報告します。

重大度

  • 大罪:確認済みの秘密情報の漏えい、インジェクション/RCE の経路、データの損失や破損、認証/アクセス制御の回避。
  • 重罪:リスクのあるセキュリティ制御、N+1 またはホットパスのパフォーマンス低下、脆弱な非同期処理/並行処理、危険な結合、変更を妨げる巨大関数。
  • 犯罪:広範な型の不適切な使用、隠れた状態、不適切なエラー処理、リスクのあるロジックに対するテストの不足。
  • 粗雑さ:重複した形式的処理、AI 風の冗長さ、不明瞭な命名、保守を遅らせるスタイルの残骸。
  • 軽犯罪:TODO の化石、コンソールログ、フォーマットのノイズ。 問題が 20 件以上ある場合は、影響度と確信度に基づいて上位 10 件を優先し、重要な指摘と重複するノイズを分けます。

スマートルート — 現在のステップで必要なものだけを読み込む

  • ターゲットが決まり、調査の準備ができたら、references/roast-playbook.md を読み込みます。調査、棚卸し、検死、修正前のチェックポイントを段階ごとに進める方法が記載されています。
  • 棚卸しを作成し、一般的な臭いを順位付けする際は references/sin-catalog.md を読み込みます。言語固有のパターンや構造クエリには references/language-sins.md を読み込みます。コードに適した根拠を選びます。
  • チェックポイントでユーザーが修正を選んだら、references/redemption-flow.md を読み込みます。承諾を得た修正と検証を通じて、指摘を解消します。
  • 範囲がモノレポや多くのカテゴリにまたがる場合は、references/parallel-roasting.md を読み込みます。指摘を重複させずに、調査と棚卸しを作業者間で分割します。
  • 調査ツールが必要な場合は、references/octocode.md を読み込み、利用可能なら octocode-research を使います。冗談を言う前に検証し、カバレッジが低下した場合はその旨を明記します。
  • このスキルを改善する場合は、octocode-graph-eval を優先します。それ以外の場合は references/improve-loop.md を読み込みます。採用/差し戻しの基準を必須とします。

関連ルート

  • 根拠の収集には octocode-research を使います。レビューの有用性の測定には octocode-graph-eval を使います。octocode-prompt-optimizer は口調や指示の表現に限って使います。
  • このスキルフォルダーを変更する場合は octocode-skills を使います。

出力

次を使います:Top roast、Important findings、Redundant / low-value findings、Autopsy、Redemption paths、Fix checkpoint。各指摘には file:line、根拠、影響度、確信度、修正方法を含めます。

スクリプト

なし — このスキルは指示のみで構成されています。根拠は octocode-research とホスト側のリポジトリツールから得ます。検証では対象プロジェクト独自のチェックを実行します。

コメント