AGENT SKILL

specrew-review

Run live continuous co-review or replay persisted reviewer evidence for an iteration.

License 许可
MIT
所属仓库
alonf/KeyContextAI
最近更新
2026-08-28
Stars
★ 0
Forks
0

01 前言 Front Matter

name
specrew-review
description
Run live continuous co-review or replay persisted reviewer evidence for an iteration.

02 资源文件 1

03 SKILL.md 正文

specrew-review

Type: Operational Skill Schema: v1 Status: Active Namespace: /specrew Canonical command: /specrew-review

Purpose

Trigger or inspect the Specrew review-oriented workflow. Use live mode to run the continuous co-review runtime and persist reviewer evidence under .specrew/review/inline/<run-id>/; use replay mode to inspect an existing reviewer closeout packet for a completed iteration.

When to Use

  • When a reviewer needs a live continuous co-review run before or during a review boundary.
  • When a reviewer wants to inspect the review summary for a completed iteration.
  • When replaying the reviewer closeout packet.
  • Invoke this skill when the user says: "Run the reviewer", "Run live review", "Show the review summary", "Review the iteration", "Show reviewer output".

Boundary Safety

This skill supports review work but does not bypass the required human decision point. A human reviewer must still explicitly approve lifecycle advancement. Invoking /specrew-review is not equivalent to approving an iteration for closure or advancement.

Feature 016 rule: Humans remain the approval authority for major boundary transitions. This command may not imply authorization to advance from any lifecycle boundary.

Coexistence Contract

This skill is part of the /specrew-* command surface. It coexists with /speckit.* review-related commands without collision or shadow. Using /specrew-review does not substitute for /speckit.* lifecycle actions that require explicit human authorization.

Invocation

/specrew-review [<iteration>] [--project-path <path>] [--feature <id>]
                 [--iteration <NNN>] [--quiet] [--json] [--open]
/specrew-review --live [--baseline-ref <git-ref>] [--project-path <path>]   # baseline auto-anchors for signoff; an explicit --baseline-ref run is exploratory-only
                 [--checkpoint-id <id>] [--run-id <id>] [--host <host>]
                 [--model <model>] [--effort <effort>] [--authorization-ref <ref>]
                 [--code-writer-host <host>]
                 [--design-context-ref <path>] [--allowed-path <path>]
                 [--forbidden-path <path>] [--exclude-path <path>]
                 [--reviewer-config <path>] [--schema-root <path>]
                 [--run-root <path>] [--timeout-seconds <N>]
                 [--fallback-policy <none|one-authorized-availability-fallback>]
                 [--preserve-debug]
/specrew-review --reconcile-run <run-id> [--project-path <path>]

Backed by: specrew review / scripts/specrew-review.ps1

Inputs

Input Type Required Description
<iteration> string (positional) No Iteration number to replay (defaults to most recent closed iteration)
--project-path string No Target Specrew project path (defaults to current directory)
--feature string No Restrict lookup to one feature directory under specs\
--iteration string No Replay a specific iteration directory
--quiet flag No Emit only the stable machine-parseable digest line
--json flag No Emit JSON summary instead of the visual reviewer summary
--open flag No Open reviewer-index.md and review-diagrams.md when present
--live flag No Run the continuous co-review runtime instead of replaying prior closeout state
--baseline-ref string Yes for --live Git ref used to compute the review change set
--checkpoint-id string No Stable checkpoint identifier for the live review request
--run-id string No Explicit run id for evidence under .specrew/review/inline/<run-id>/
--host string No Reviewer host to request (claude, codex, copilot, cursor-agent, or antigravity)
--model string No Reviewer model override; non-default models require --authorization-ref
--effort string No Optional host-specific reviewer reasoning/effort label persisted in evidence
--authorization-ref string No Human authorization reference for host/model selection
--code-writer-host string No Implementation host (claude, codex, etc.) used to prefer an independent peer reviewer
--design-context-ref string No Design or lifecycle artifact to include in the review request context
--allowed-path string No Add a mutable path allowlist entry for this live review run
--forbidden-path string No Add a protected path entry for this live review run
--exclude-path string No Add a change-set exclusion entry for this live review run
--reviewer-config string No JSON reviewer host configuration for deterministic or authorized hosts
--schema-root string No Contract schema root for ReviewRequest and FindingsResult validation
--run-root string No Override the evidence output root; defaults to .specrew/review/inline
--timeout-seconds number No Live reviewer host timeout
--fallback-policy string No Host fallback policy (none or one-authorized-availability-fallback)
--preserve-debug flag No Preserve debug artifacts from the live review run
--reconcile-run string No Resume one interrupted campaign run without invoking or retrying a provider

Outputs

  • Live ReviewRequest, prompt bundle, host invocation metadata, FindingsResult, gate verdict, and run index under .specrew/review/inline/<run-id>/ when --live is used.
  • Reviewer closeout packet for the specified iteration when replay mode is used.
  • Raw/native output from the underlying specrew review workflow with minimal wrapper context.

Argument Whitelist

Only the arguments listed above are accepted in v1. Unknown arguments are rejected with command-specific help guidance.

Failure Guidance

Failure mode Behavior
Unsupported argument Rejected immediately with command-specific help guidance
Missing --baseline-ref in live mode Error explaining that live review needs a baseline ref
Unauthorized reviewer host/model Infrastructure failure with reviewer authorization guidance; do not treat this as reviewer approval
No iteration found Error with guidance to check specs/ directory structure
Missing project setup Stop with specrew init remediation

See Also

  • /specrew-where — current project status (live, not review replay)
  • /specrew-help — catalog fallback and full command list

04 同仓库更多 Skills