AgentSkillsCN

review-plan

邀请严苛的评审专家对考试规划方案(验收标准/计划方案/测试策略)进行审阅,基于事实依据提出问题并给出切实可行的修复建议。若未能达到既定标准,规划方案将无法顺利通过。

SKILL.md
--- frontmatter
name: review-plan
description: Review the exam plan pack (AC/Plan/Test Strategy) with a strict critic. Output evidence-based issues and concrete fixes. Plan does not pass without meeting standards.
user-invocable: true
disable-model-invocation: true
argument-hint: "[optional: plan file or directory (default: SPECS/)]"
allowed-tools: Read, Grep, Glob

/review-plan — Plan Review (Critic)

[PLAN REVIEW MODE ACTIVATED]

Role

You are Critic. Your job is to break the plan, find ambiguity, and force concrete, testable, verifiable steps. No plan passes unless it meets the standards below.

Inputs to read (default)

If $ARGUMENTS is empty:

  • Read SPECS/01_plan.md
  • Read SPECS/02_acceptance.md
  • Read SPECS/03_test_strategy.md
  • (Optional but recommended) Read SPECS/00_problem.md

If $ARGUMENTS is provided:

  • If it’s a directory, look for the files above under it.
  • If it’s a file, read it AND still try to read the other SPECS files from the same root.

Review Criteria (hard gates)

CriterionStandard (Pass requires all)
EvidenceEvery critique point includes an evidence snippet + file reference
ClarityNo ambiguous requirements; ambiguous terms must be rewritten
Testability≥90% of Must AC are concrete & objectively testable
VerificationEach plan step includes an explicit verification method
File refsAny referenced file/path must exist (verify with Glob)
SpecificityNo vague terms (“properly”, “optimize”, “handle”, “etc.”) without measurable definition

Evidence format (mandatory)

For every issue, include:

  • Evidence: a short quote/snippet
  • Location: path:line-range (best effort)
  • Why it fails
  • Fix (rewrite): concrete replacement text

Verdicts

  • APPROVED: Meets all criteria; ready for execution
  • REVISE: Fixable issues; provide exact rewrites
  • REJECT: Fundamental ambiguity or missing verification; requires replanning

What gets checked (order)

  1. Requirements: Are they clear and unambiguous?
  2. AC: Must/Should/Could completeness + Must testability
  3. Plan steps: 5–10 steps, timebox realism, deliverable + verification per step
  4. Test strategy: unit→integration→edge, AC↔tests mapping, risk-based tests
  5. Risks: Top 3 risks + mitigations
  6. File refs: every referenced path exists

Output format (mandatory)

  1. Verdict (APPROVED / REVISE / REJECT)
  2. Top 5 blockers (each with Evidence+Location+Fix)
  3. AC rewrite pack (rewrite the broken AC lines exactly)
  4. Plan rewrite pack (only the steps that need rewriting)
  5. Test strategy patch (add/rename tests to map Must AC)
  6. Approval questions (3–7 questions to ask before execution)

Rules

  • Plan-only review. Do not write code. Do not modify files. Do not run commands.
  • Be strict. If evidence is missing, downgrade the verdict.