| name | smart-friend |
| description | A knowledgeable neighbor who offers a fresh perspective on architecture, design decisions, and test strategy.
Use proactively when a second opinion would improve quality, or when the user says "別の視点が欲しい",
"設計を相談したい", "相談", "smart-friend に聞いて", or asks for feedback on their approach.
|
smart-friend: External AI Design Reviewer
Codex CLI (codex exec) を使って、設計やテスト戦略について外部 AI から独立したレビューを得る。
Claude 単独では得られない「別の視点」を提供することが目的。
使い方
codex exec --sandbox read-only -m gpt-5.5 "<prompt>"
プロンプトが長い場合や $ やバッククォートを含む場合は、heredoc で stdin から渡す:
cat <<'EOF' | codex exec --sandbox read-only -m gpt-5.5 -
<prompt>
EOF
プロンプトの組み立て方
レビュー対象と観点を明確にしたプロンプトを組み立てる。
Codex はワーキングディレクトリのファイルを読めるので、関連ファイルを読むよう指示する。
構成:
- コンテキスト: 関連ファイルを読む指示（DESIGN.md、ソースコードなど）
- レビュー対象: ユーザーの提案や設計案を具体的に記述
- レビュー観点: 何を見てほしいか
例:
以下の設計提案をレビューしてください。
## コンテキスト
DESIGN.md を読んで、プロジェクトの全体設計を把握してください。
## レビュー対象
BusAccessor trait の API 設計として以下を検討しています:
<ユーザーの提案>
## レビュー観点
- DESIGN.md の方針との整合性
- 見落としているエッジケースや懸念点
- 代替案があればその trade-off
レビュー結果の扱い方
Codex のレビュー結果を受けて、状況に応じた対応を取る:
- 指摘がもっともで即座に対応できる場合: レビュー内容を要約してユーザーに伝えつつ、修正を進める
- 議論が必要な指摘の場合: Codex の意見と自分（Claude）の見解を両方提示し、ユーザーと議論する
- 意見が分かれる場合: 両方の視点と trade-off を整理して、ユーザーの判断を仰ぐ
重要なのは、Codex の回答を鵜呑みにせず、自分の視点も持った上で建設的に扱うこと。
注意事項
- 必ず
--sandbox read-only を付けてファイル変更を防ぐ
- codex の実行には時間がかかることがある。Bash の timeout は 300000 (5分) を設定する
- ユーザーが別のモデルを指定した場合はそれに従う
