AgentSkillsCN

codex-plan-critique

在规划阶段,以Codex CLI作为同行评审工具使用。在“规划实施方案”“设计解决方案”“处于规划模式”“架构功能特性”或即将“提出规划方案”时使用,以便在向用户展示之前获得专业意见与反馈。

SKILL.md
--- frontmatter
name: codex-plan-critique
description: Invoke Codex CLI as peer reviewer during planning phases. Use when "planning an implementation", "designing a solution", "in plan mode", "architecting a feature", or about to "propose a plan" to get critique before presenting to user.

Codex Plan Critique

Invoke Codex CLI to peer-review plans before presenting to user. Codex runs in the project directory with visibility to all files.

Workflow

  1. Write plan to a temp file (e.g., /tmp/plan-critique.md)
  2. Run critique script with project dir and user prompt
  3. Display critique to user
  4. Incorporate valid concerns into final plan

Running the Critique

bash
scripts/codex-critique.sh <plan-file> <project-dir> "<user-prompt>"

Arguments:

  • plan-file - Path to plan file
  • project-dir - Project root (Codex runs here for file access)
  • user-prompt - Original user request for context

Example:

bash
scripts/codex-critique.sh /tmp/plan.md /Users/ad/myproject "Add user authentication"

Output format:

  • Verdict: APPROVE or CONCERNS
  • Strengths: What's good
  • Concerns: Issues with suggestions

Display Format

Present critique to user:

code
★ Codex Peer Review ─────────────────────────
[Critique output here]
──────────────────────────────────────────────

Error Handling

If Codex unavailable:

  • Log warning
  • Continue without blocking
  • Note: "Peer review skipped - Codex unavailable"

Requirements

  • codex CLI installed and authenticated
  • OPENAI_API_KEY or codex login