Skills

Review Triage Phase

Produces canonical review actions from fetched review state and renders action markdown.

Install

npx skills add prisma/orm --skill review-triage-phase -g -a claude-code -y
Repository
prisma/orm47.7k
Category
Engineering
Updated
4d ago
License
Apache-2.0
Context cost
Lightabout 929 tokens
Runs scripts
Yes, review before use

What it does

Produces canonical review actions from fetched review state and renders action markdown. Use when the user wants only triage/action-planning for the review-framework workflow.

Review Triage Phase

Run only the triage phase of the review-framework loop:

read current review state artifacts, bootstrap canonical review-actions.json, update triage fields, validate, then render review-actions.md.

Run commands from this skill directory. All script paths below are relative to it.

Inputs

  • Required:
    • PR URL
  • Optional:
    • output directory

If output directory is omitted, derive:

wip/reviews/<owner>_<repo>_pr-<number>/

Preconditions

Expected inputs in output dir:

  • <output-dir>/review-state.json
  • <output-dir>/review-targets.json (optional)
  • <output-dir>/review-state.md (optional)
  • <output-dir>/summary.txt (optional)

If review-state.json is missing, instruct user to run:

  • /review-fetch-phase <PR_URL> [output-dir]

Note:

  • review-actions.json scaffolding is generated from review-state.targets, taking the thread and review-body targets. Issue-comment targets are captured in review-state.json but get no scaffolded action.
  • Compound review bodies: A single pull_request_review target may contain multiple distinct findings (e.g., CodeRabbit bundles "outside diff range" comments, actionable comments, and nitpicks into one review body). The triager must decompose these into individual action items during triage, never blanket-dismiss a review body without reading its content.

Behavior

  1. Compute deterministic paths:
    • <output-dir>/review-state.json
    • <output-dir>/review-actions.json
    • <output-dir>/review-actions.md
  2. Enforce artifact safety before generation (the artifacts must stay untracked). In a git checkout the guard asks git directly; in a Jujutsu workspace with no git directory it accepts a directory under the workspace root's ignored wip/ tree:
node ../review-fetch-phase/scripts/guard-review-artifacts-ignored.mjs --dir <output-dir>
  1. Bootstrap canonical action scaffold from review state:
Read the whole SKILL.md on GitHub

More in Engineering