agent-review

エージェントレビュー

外部の AI エージェントからフィードバックを得られます。コードレビュー、アーキテクチャの判断、セカンドオピニオンを求める場合に便利です。

コマンドの実行

echo "code or prompt" | node .claude/skills/agent-review/query.mjs [options] "Your question"
# or
node .claude/skills/agent-review/query.mjs --file <path> [options] "Your question"

オプション

フラグ	短縮形	説明
--model <model>	-m	モデルまたはエイリアス（デフォルト：gemini）
--file <path>	-f	stdin の代わりにファイルから入力を読み込みます
--lines <start-end>	-l	ファイルから特定の行を抽出します（例：50-100）
--context <path>	-c	追加のコンテキストファイル（複数指定可）
--system <prompt>	-s	カスタムシステムプロンプト
--temperature <n>	-t	Temperature 0-1（デフォルト：0.7）
--quiet	-q	ステータスメッセージと使用状況の統計を表示しません
--list		利用可能なモデルを一覧表示します
--json		未加工の JSON レスポンスを出力します

利用可能なモデル

モデル ID	エイリアス	プロバイダー	備考
google/gemini-3-pro-preview	gemini, g3	OpenRouter	デフォルト — 外部の視点を得るのに適しています
openai/gpt-5.1-codex	gpt, codex, gpt5	OpenRouter	コード分析に強いモデルです
anthropic/claude-opus-4.5	opus, claude-opus	Agent SDK	ローカルのサブスクリプションを使用します
anthropic/claude-sonnet-4.5	sonnet, claude	Agent SDK	ローカルのサブスクリプションを使用します

Anthropic モデルは Claude Agent SDK 経由でルーティングされます（Claude のサブスクリプションを使用します）。 その他のモデルは OpenRouter API 経由でルーティングされます（OPENROUTER_API_KEY が必要です）。

環境変数

変数	必須	説明
OPENROUTER_API_KEY	Anthropic 以外のモデルで必要	OpenRouter API キー
AGENT_REVIEW_DEFAULT_MODEL	いいえ	デフォルトモデルを上書きします

使用例

コードレビュー

# Review a file for security issues
cat src/server/auth.ts | node .claude/skills/agent-review/query.mjs \
  "Review this authentication code for security vulnerabilities"

# Review with a specific model (using alias)
node .claude/skills/agent-review/query.mjs -m gpt -f src/utils/parser.ts \
  "Review this parser for edge cases and error handling"

特定の行のレビュー

# Review a specific function (lines 50-100)
node .claude/skills/agent-review/query.mjs \
  -f src/server/auth.ts -l 50-100 \
  "Review this authentication function for security issues"

# Review a single line
node .claude/skills/agent-review/query.mjs \
  -f src/utils/parser.ts -l 42 \
  "Is this regex safe from ReDoS attacks?"

コンテキストファイルを使用する

# Review code with type definitions as context
node .claude/skills/agent-review/query.mjs \
  -f src/api/routes.ts \
  -c src/types/api.ts \
  -c src/types/models.ts \
  "Review this API implementation"

# Review component with its hooks as context
node .claude/skills/agent-review/query.mjs \
  -f src/components/UserProfile.tsx \
  -c src/hooks/useUser.ts \
  "Review this React component for performance issues"

アーキテクチャに関するフィードバック

# Get feedback on a proposed design
cat docs/design-proposal.md | node .claude/skills/agent-review/query.mjs \
  "What are the potential issues with this architecture?"

カスタムシステムプロンプト

node .claude/skills/agent-review/query.mjs \
  -f src/api/routes.ts \
  -s "You are a security expert specializing in API design" \
  "Audit this API for OWASP top 10 vulnerabilities"

Temperature の制御

# Lower temperature for more deterministic analysis
node .claude/skills/agent-review/query.mjs -t 0.2 -f src/algo.ts \
  "Analyze the time complexity"

# Higher temperature for creative suggestions
node .claude/skills/agent-review/query.mjs -t 0.9 -f src/ui.tsx \
  "Suggest ways to improve the user experience"

Anthropic モデルを使用する（ローカルのサブスクリプション）

# Uses Claude Agent SDK - no API credits consumed
node .claude/skills/agent-review/query.mjs -m opus -f complex-algorithm.ts \
  "Analyze the time complexity and suggest optimizations"

Quiet モード（スクリプト用）

# Suppress all status messages, only output the response
REVIEW=$(node .claude/skills/agent-review/query.mjs -q -f src/auth.ts \
  "List security issues as JSON array")
echo "$REVIEW" | jq .

出力

レスポンステキストは stdout に書き込まれます。レスポンスの後に、使用状況の統計が stderr に表示されます。

Tokens: 189 in / 871 out (1060 total)
Cost: $0.0108

これにより、OpenRouter リクエストのトークン消費量とコストを追跡できます。表示を抑制するには --quiet を使用します。

使用する場面

• コードレビュー：コードの品質、セキュリティ、パフォーマンスについてセカンドオピニオンを得る
• アーキテクチャの判断：別の視点から設計上の選択を検証する
• バグ分析：エラーのコンテキストを共有して、デバッグの提案を得る
• ドキュメントレビュー：ドキュメントが明確で完全かどうかを確認する
• テストカバレッジ：不足しているテストケースを特定する

ヒント

• ほとんどの外部レビューにはデフォルトモデル（Gemini 3 Pro）をおすすめします
• Claude のスタイルとの一貫性を求める場合は Anthropic モデルを使用します
• ファイル全体を送信せず、-l を使って特定の関数をレビューすると、トークンを節約できます
• より適切なコンテキストを提供するには、-c を使って型定義や関連ファイルを含めます
• より焦点を絞った／決定性の高い回答には -t 0.2 を、創造的な提案には -t 0.8 を使用します
• 手早くレビューするには、コードを直接パイプします：cat file.ts | node ... "review this"