mcpField
K
kodevu

kodevu

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

kodevu について

kodevu は、対応する AI レビュアー CLI を使って Git のコミットや SVN のリビジョンを調べる Node.js コマンドラインツールです。Markdown または JSON のレポートを生成し、レビュアーやプロンプト、永続設定を指定できます。

主な機能

  1. 01Git コミットと SVN リビジョンのレビュー
  2. 02未コミット変更のレビュー
  3. 03対応するレビュアーバックエンドの選択
  4. 04Markdown または JSON レポートの生成
  5. 05プロンプトと永続設定の指定

活用シーン

  1. 01最新または指定したコミットのレビュー
  2. 02コミット前の未コミット変更の確認
  3. 03レビュー結果を指定先に JSON 保存
  4. 04カスタムレビュー指示の適用

インストール

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

$npx skills add https://github.com/gyteng/kodevu --skill kodevu

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

同梱ファイル

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

package.json
.eslintrc.json
eslint.config.js
LICENSE
README.md
.gitignore
package-lock.json
.github/workflows/
publish-npm.yml
src/
diff-processor.js
config.js
logger.js
index.js
report-generator.js
shell.js
review-runner.js
progress-ui.js
git-client.js
svn-client.js
reviewers.js
prompts.js
token-usage.js
vcs-client.js
utils.js

詳細

Kodevu スキル

Kodevu は、Git のコミットまたは SVN のリビジョンを取得し、差分を対応する AI レビュアー CLI に送信して、レビュー結果をレポートファイルに書き込む Node.js ツールです。セッションをまたいで保持する設定用に、任意の永続設定ファイル ~/.kodevu/config.json をサポートしています。

使い方

npx kodevu を使用してコードベースをレビューします。

最新のコミットをレビューする
npx kodevu .
特定のコミットをレビューする
npx kodevu . --rev <commit-hash>
直近の N 件のコミットをレビューする
npx kodevu . --last 3
未コミットの変更をレビューする
npx kodevu . --uncommitted
対応するレビュアー

kodevu は、auto、openai、gemini、codex、copilot など、複数の AI レビュアーバックエンドに対応しています。デフォルトは auto で、PATH 内の利用可能な CLI ツールを確認します。

OpenAI を使用する例：

npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-5-mini
JSON レポートの生成

デフォルトでは、レビュー結果は ~/.kodevu/ に Markdown ファイルとして生成されます。--format json を指定するか、--output <dir> を使用して出力先ディレクトリを変更できます。

npx kodevu . --format json --output ./reports
カスタムプロンプト

--prompt を使用して、レビュアーに追加の指示を指定できます。

npx kodevu . --prompt "Focus on security issues and suggest optimizations."

ファイルから指定することもできます：--prompt @my-rules.txt

環境変数

繰り返しフラグを指定する手間を省くため、すべてのオプションは環境変数でも設定できます。

  • KODEVU_REVIEWER – デフォルトのレビュアー。
  • KODEVU_LANG – デフォルトの出力言語。
  • KODEVU_OUTPUT_DIR – デフォルトの出力先ディレクトリ。
  • KODEVU_PROMPT – デフォルトのプロンプト指示。
  • KODEVU_OPENAI_API_KEY – openai の API キー。
  • KODEVU_OPENAI_BASE_URL – openai のベース URL。
  • KODEVU_OPENAI_MODEL – openai のモデル。
設定ファイル

シェルや AI ツールの呼び出しをまたいで設定を保持するには、~/.kodevu/config.json を作成します。

{
  "reviewer": "openai",
  "openaiApiKey": "sk-...",
  "openaiBaseUrl": "https://your-gateway.example.com/v1",
  "openaiModel": "gpt-4o",
  "lang": "zh"
}

このファイルは任意で、存在しない場合はエラーなく無視されます。優先順位は CLI フラグ > ENV 変数 > 設定ファイル > デフォルト です。

対象リポジトリの操作

  • Git：target はローカルリポジトリまたはサブディレクトリである必要があります。
  • SVN：target には作業コピーのパスまたはリポジトリ URL を指定できます。
npx kodevu /path/to/project --last 1

コメント

Markdown 対応