Imported from HelloiOS2014/AgentBridge (hosts/pi/package/skills/codex-review/SKILL.md). Install upstream with npx skills add HelloiOS2014/AgentBridge --skill codex-review. Copyright stays with the author.

Codex Review (AgentBridge)

Delegate read-only code/design review to local Codex.

When To Use

• Normal review of working tree / branch changes.
• Adversarial review when the user wants challenge, alternatives, failure modes (pass focus text in the prompt; use adversarial-review).

When Not To Use

• User only wants Pi local review.
• User asked for fixes/edits (use codex-rescue with explicit write intent instead).

Safety

• Review is read-only. Never pass --write.
• No bare/yolo/bypass flags.
• Do not auto-fix findings.

Commands

The wrapper and engine are provided by the agent-bridge-pi Package; no manual env export is required.

Self-bootstrap: install engine from Host package on first use (idempotent, version-guarded)

AB_PLUGIN_VERSION="$(find "${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}" -path "agent-bridge-pi" -name version -type f -not -path "/.git/" 2>/dev/null | sort -V | tail -n1)" if [ -n "$AB_PLUGIN_VERSION" ] && { [ ! -x "$HOME/.agent-bridge/bin/agent-bridge-pi" ] || [ "$(cat "$HOME/.agent-bridge/engine/version" 2>/dev/null)" != "$(cat "$AB_PLUGIN_VERSION")" ]; }; then AB_PLUGIN="$(dirname "$AB_PLUGIN_VERSION")" rm -rf "$HOME/.agent-bridge/engine" && mkdir -p "$HOME/.agent-bridge/engine" "$(dirname "$HOME/.agent-bridge/bin/agent-bridge-pi")" &&
cp -R "$AB_PLUGIN/src" "$HOME/.agent-bridge/engine/" && cp "$AB_PLUGIN/package.json" "$HOME/.agent-bridge/engine/" && cp -R "$AB_PLUGIN/skills-templates" "$HOME/.agent-bridge/engine/" &&
cp "$AB_PLUGIN/version" "$HOME/.agent-bridge/engine/version" && cp "$AB_PLUGIN/bin/agent-bridge-pi" "$(dirname "$HOME/.agent-bridge/bin/agent-bridge-pi")/" &&
chmod +x "$HOME/.agent-bridge/bin/agent-bridge-pi" fi

Normal review:

"$HOME/.agent-bridge/bin/agent-bridge-pi" codex review --json

Adversarial / focused review:

"$HOME/.agent-bridge/bin/agent-bridge-pi" codex adversarial-review --json --prompt "$FOCUS"

Optional: --cwd "$WORKSPACE". If the user gave a file / image / design mock to review, pass it with --attach "$FILE" (absolute path, repeatable).

After The Result

• Present findings first; keep file references and residual risk.
• Do not start implementing fixes unless the user explicitly requests it.
• 优先呈现 summary；若 storage.truncated=true 需要全文，用 agent-bridge result "<job-id>" --full 按需取回，不要把超长输出整段复制进对话。