Files
dotfiles/pi/.pi/agent/skills/subagent-review/SKILL.md
2026-04-05 09:34:38 +02:00

2.0 KiB

name, description
name description
subagent-review Code review using a cross-family reviewer. Use when the user invokes /review.

/review — Code Review

Agent Roster

Agent Role
reviewer Cross-family code review (finds blind spots the author's model family misses)
fixer Applies review feedback precisely

Workflow

Single reviewer call — no chain needed:

await subagent({ agent: "reviewer", output: `${chainDir}/review.md`, task: "Review the following changes: <description or files>" })

Read review.md. If issues found, apply fixes:

await subagent({ agent: "fixer", task: `Read and apply the review feedback in ${chainDir}/review.md` })

Workflow Summary

After review (and optional fix), give the user a brief honest summary:

  • What happened: did the reviewer find issues, were fixes applied?
  • Issues: any agent silent failures, fallbacks used, or unexpected behavior
  • Agent quality: did any agent misinterpret the task, produce poor output, or need hand-holding? Name the agent and the problem
  • Skill improvements: did this workflow reveal gaps in the skill instructions or agent prompts? Note what should change

Be concise — a few lines is enough when things went well. Only expand on problems.

Fallback Strategy

When a subagent call returns no output (silent failure), apply cross-family model fallback. Do not fall back to doing the work yourself — always retry with the fallback model first.

  1. First attempt: Use the agent's default model
  2. If silent failure or error: Retry with the fallback model using model override
  3. If the fallback also fails: Report the double-failure to the user. Still do not do the work yourself.
// Example: reviewer fails silently, retry with fallback
subagent({ agent: "reviewer", task: "...", model: "zai/glm-5.1" })
Agent Primary Fallback
reviewer anthropic/claude-opus-4-6 zai/glm-5.1
fixer anthropic/claude-sonnet-4-6 zai/glm-5.1