codex-copilot-review

name

codex-copilot-review

description

Run a reusable cross-repo code review workflow where Codex prepares a handoff, Copilot CLI reviews the diff in Simplified Chinese, and Codex can optionally continue fixing accepted issues afterward. Use for requests to review the current change, choose a review model, run a Chinese review, auto-review after push, continue fixing code based on the latest review, or push-review-follow-up in one flow.

Codex Copilot Review

Use this skill from any git repository. Do not expect the repository to contain custom scripts or package.json commands.

Global locations

The reusable workflow lives here:

• Skill root: <CODEX_HOME>\skills\codex-copilot-review
• Script directory: <CODEX_HOME>\skills\codex-copilot-review\scripts
• Location reference: <CODEX_HOME>\skills\codex-copilot-review\references\locations.md
• Global command entry: codex-review or codex-copilot-review

The Copilot reviewer assets are installed here and are also bundled with this skill:

• Copilot agent: <USERPROFILE>\.copilot\agents\opus-review.agent.md
• Copilot skill: <USERPROFILE>\.copilot\skills\diff-review\SKILL.md

The runtime output for the active repository always goes under:

• <repo>\.codex-workflows\copilot-review\

The workflow also auto-adds /.codex-workflows/ to <repo>\.git\info\exclude, so these runtime files stop appearing in git status.

That output folder contains:

• copilot-review-handoff.md
• reports\copilot-review-*.md
• codex-review-followup.md
• followups\codex-review-response-*.md

Routing

Map natural-language requests to these scripts:

1. Review the latest change in Chinese.

Use:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\update-copilot-review-handoff.ps1 -BaseRef HEAD~1

Then:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\start-copilot-review.ps1 -Inline -CopilotCommand copilot

2. Review the latest change, then let Codex continue automatically.

Use:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\update-copilot-review-handoff.ps1 -BaseRef HEAD~1

Then:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\start-copilot-review.ps1 -Inline -CopilotCommand copilot -AutoCodexFollowup

3. Push and auto-review the current branch.

Use:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\push-with-copilot-review.ps1 -CopilotCommand copilot

4. Continue fixing code based on the latest review.

Use:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\start-codex-review-followup.ps1 -Inline -CodexCommand codex

5. Push, review, and let Codex continue automatically.

Use:

pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File <CODEX_HOME>\skills\codex-copilot-review\scripts\push-with-copilot-review.ps1 -CopilotCommand copilot -AutoCodexFollowup -CodexCommand codex

6. Call the whole workflow through a single command entry.

Use:

codex-review "push review and follow up"

or:

codex-review -Mode push-review-followup

Model selection

The single-command entry accepts fuzzy model language:

• 5.5, gpt5.5 -> gpt-5.5
• 5.4, gpt5.4 -> gpt-5.4
• mini, gpt5mini -> gpt-5.4-mini
• 4.7opus, opus4.7, claude4.7opus -> claude-opus-4.7
• sonnet -> claude-sonnet-4.5

Examples:

• codex-review "use 5.5 for cr"
• codex-review "review with 4.7opus then follow up with 5.5"
• codex-review "codex use mini to fix"

Defaults

When the user does not specify extra parameters:

1. For "current change" style review requests, use -BaseRef HEAD~1.
2. For push-and-review requests, let the handoff script auto-detect the default base branch.
3. Use gpt-5.4 for Copilot review.
4. Do not pass a Codex follow-up model unless the user explicitly asks for one; let Codex CLI use its current default.
5. Infer Summary from the active task in one sentence.
6. Infer ReviewFocus from the highest-risk regression area.
7. If validation is unknown, use No extra validation ran in this round.

Execution rules

1. Always run inside the target git repository.
2. Always let Copilot review only the generated handoff diff range.
3. Keep the final Copilot review report in Simplified Chinese.
4. Keep the final Codex follow-up summary in Simplified Chinese.
5. Report the generated handoff, review, or follow-up file path back to the user.
6. If the Copilot assets are missing from ~/.copilot, the bundled scripts will restore them automatically from this skill.