HN 日本語サマリー

← 一覧へ戻る
プログラミング

Jev ベースのコードレビュー

Jev Based Code Review (github.com)

48 pointsby namanbhulawat57 コメント

要約

Jev Code Reviewerは、AIエージェントが生成するプルリクエスト(PR)のレビュー負荷を軽減するためのツールです。変更をP0、P1、P2の優先度で分類し、デフォルトではP0のみを表示することで、人間のレビュアーの負担を減らします。自然言語での差分表示や、ローカル実行によるプライバシー保護も特徴です。

全文翻訳

Jev-Code-Reviewer

エージェントによって生成される多くのPRは、一度に大量のファイル変更が表示されるため、人間が理解するのが困難です。これは、各レビューの変更をP0、P1、P2に分類することで、精神的な負担を軽減する試みです。デフォルトではP0のみが表示されます。優先度は設定可能です。差分は自然言語でも表示されます。元のコードはトグルで切り替え可能です。

これは、自身のコーディングエージェントのPRをレビューするために、お使いのコンピューター上で実行され、GitHubに何も投稿しません。

[画像: デモンストレーションPRでのJev-Code-Reviewer]

録画を見る · デモPRを開く。バンドルされた録画は、実際のJev分類とラベル付けされた準備済みの説明コピーを使用しています(出所)。

クイックデモ

Node.js 22+ が必要です。

git clone https://github.com/egma-ai/jev-code-reviewer.git
cd jev-code-reviewer
npm install
npm run demo

プロバイダー呼び出しを行わないリプレイについては http://127.0.0.1:4731/demo を開くか、拡張機能(下記参照)をロードして デモPRの変更ファイルページ を開いてください。

自身のPRをレビューする

GitHub CLI でサインイン(gh auth login)し、origin がPRのリポジトリであるローカルクローンが必要です。

npm link                 # jev-reviewer コマンドを追加します
jev-reviewer setup       # TypeSafe と OpenAI のキーを保存します。ご自身のターミナルで実行してください。
jev-reviewer doctor      # ツール、キーソース、ローカルサーバー、プロバイダーアクセスを確認します
jev-reviewer serve       # 実行したままにしておきます
jev-reviewer analyze --pr https://github.com/OWNER/REPO/pull/123 --repo /path/to/clone

次にChromeで以下を行います:

  1. chrome://extensions を開き、開発者モードをオンにし、拡張機能の読み込みをクリックして、このリポジトリの extension/ フォルダを選択します。
  2. jev-reviewer token | pbcopy を実行します。拡張機能のポップアップで、Connection を開き、ペーストして Save をクリックします。Paired と表示されるはずです。
  3. PRの Files changed ページ(/pull/<n>/files)を開き、Show logic in place of code をオンにします。

オプション:uv tool install graphifyy は、より良いコンテキストのためにローカルコードグラフを追加します。コーディングエージェントがPRを開いた後に analyze を実行するようにするには、エージェントスキル をインストールしてください。

知っておくと良いこと

  • コードはあなたのマシンから離れます。 analyze は変更されたコードと近傍のコンテキストを TypeSafe と OpenAI に送信します。拡張機能は 127.0.0.1:4731 上のローカルサーバーとしか通信しません。
  • キーは ~/.config/jev-reviewer/credentials.json に保存されます(所有者のみ、暗号化されていません)。コーディングエージェントのシェルがしばしば見ることができないエクスポートされた変数よりもこちらを推奨します。OpenAI キーを置き換えるには node scripts/setup-keys.mjs --replace-openai を使用します。
  • カバレッジは制限されています。 パス順で最初の12個の変更ユニット(diff hunks)が分析されます。--max-units は最大100まで許可します。分析されていない変更があるファイルはGitHubのコードを保持し、CLIとポップアップにその数が表示されます。
  • クラシックな変更ファイルページのみ対応。 GitHubの新しい /changes ページはまだサポートされていません。プロフィール写真 → Feature preview から元に戻してください。
  • 古いレポートは決して表示されません。 PRに新しいコミットがある場合、拡張機能はGitHubのコードを保持します。analyze を再実行してから Refresh report をクリックしてください。
  • 優先度は正確さではなく、注意を意味します。 P0ファイルはデフォルトで開きます。P1とP2は折りたたまれた状態で開始します。レビュー対象のリポジトリのルートに config/policy.json をコピーして .jev-reviewer.json として保存するか、--policy を渡すことで調整できます。

開発

npm test
node scripts/test-extension.mjs   # Chromiumとポート4731の空きが必要

アーキテクチャ、デモガイド、および 拡張機能の詳細 を参照してください。

MIT。