agentleFS
rumoiirumoii/rumo-engineering-skills/skills/rumo-review/SKILL.md

rumo-review

Skill7 starsChanged 14 days agoMITView on GitHub

Use for a read-only code review of uncommitted changes, a branch diff, or a commit; named-scope implementation audits; multi-model code review panels or code second opinions through agent CLIs ("多模型评审"); an explicitly requested review-fix-repeat loop until no blocking findings remain; an explicitly requested simplification audit; or addressing review feedback from someone else. Report correctness, security, lifecycle, compatibility, operations, and test risks with file-and-line evidence. For delegating research, design, or open-ended product evaluation, use rumo-agent-collaboration. Do not use for pre-handoff checks; use rumo-verify instead.

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 10 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the repository guidance and the nearest module instructions.

    line 28
  2. Distinctive:

    Do not guess the base from branch names.

    line 34
  3. Distinctive:

    Read enough surrounding code and current consumers to judge, in this order:

    line 38
  4. Very specific:

    When the target is a CI job, verifier, threshold, or other gate, also apply the gate rules in rumo-verify (still read-only).

    line 47
  5. Distinctive:

    Keep source behavior, built artifacts, deployed state, and field acceptance apart.

    line 52
  6. Distinctive:

    Treat tests and comments as evidence to weigh, not authority over production behavior.

    line 53
  7. Distinctive:

    Check that a suggested fix direction is feasible, but do not edit code in review mode.

    line 56
  8. Distinctive:

    Check each comment against the code: is the problem real, and is it inside the reviewed change?

    line 60
  9. Distinctive:

    Ask about unclear comments first.

    line 62
  10. Distinctive:

    Do not post replies, resolve threads, or request another review on the hosting platform unless the user asks.

    line 65
  11. Distinctive:

    Not a finding: "Consider more error handling.

    line 89

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Rumo Review

Lead with actionable findings, not a tour of the diff.

This skill reviews code changes and audits implementation. Delegating research, design, or open-ended product evaluation belongs to rumo-agent-collaboration, even when the user calls it a review or second opinion. Without a delegation request, answer such questions locally.

Modes

ModeTriggerEdits code
Review (default)A code review or named-scope implementation auditNo
LoopThe user explicitly asks to review, fix, and repeat; read references/loop.mdYes, must-fix items only
PanelThe user asks other models to review code or audit implementation, or you propose it for a high-risk change; read references/panel.mdNo
SimplifyThe user explicitly asks for simplification or removable-complexity findings; read references/simplify.mdNo
RespondThe user hands over review comments from a person or a tool and asks to address themYes, accepted comments only

Review (default), Panel, and Simplify modes never edit code; only Loop and Respond do, and only on an explicit request.

Nothing is sent to another model or CLI until the user agrees, as references/panel.md describes.

Settle The Target

  1. Read the repository guidance and the nearest module instructions.
  2. Pick one target: uncommitted changes, a diff against a confirmed base, a commit, or a named-scope audit of the current implementation. Use the user's stated target; ask only if it is materially ambiguous.
  3. Record repository, branch, HEAD, worktree status, and, for branch comparisons, the base and merge base.
  4. Inspect committed, staged, unstaged, and untracked changes separately; a three-dot diff hides dirty layers.
  5. Review each repository on its own.

Do not guess the base from branch names. Use the request, repository guidance, upstream tracking, or merge-request metadata, and ask only when none of them settles it.

What To Look For

Read enough surrounding code and current consumers to judge, in this order:

  1. Correctness: wrong conditions, missing states, broken error paths, stale data, behavior that contradicts the request.
  2. Security and data safety: authorization, ownership and tenant isolation, secret exposure, injection, unsafe file or process handling, destructive migrations, missing rollback.
  3. Lifecycle and concurrency: races, duplicate work, cancellation, retry, timeout, resource ownership, disposal order, partial failure.
  4. Cross-layer contracts: request and response shapes, DTOs, schema and queries, messages and cache state, generated or deployed artifacts.
  5. Compatibility and operations: supported branches, existing data, upgrades, configuration precedence, platforms, topology, observability.
  6. Test quality: tests must exercise the affected production route; a mock-only assertion, compile, HTTP 200, or coverage number is not proof.

When the target is a CI job, verifier, threshold, or other gate, also apply the gate rules in rumo-verify (still read-only).

Evidence Standard

  • Trace both sides of every changed interface and every production consumer in scope.
  • Keep source behavior, built artifacts, deployed state, and field acceptance apart.
  • Treat tests and comments as evidence to weigh, not authority over production behavior.
  • For a diff, report only issues this change introduces or materially exposes; old debt is out of scope. For a named-scope audit, report existing actionable issues inside that scope, even on a clean HEAD. Do not expand either target into unrelated debt.
  • When a caller-supplied value drives a state change (money moved, stock reserved, quota spent, a record read or written for someone), name the stored value that must bound it: balance, amount paid, stock, quota, owner, or tenant. If nothing in scope compares against it, report a finding that states the assumed invariant and which component might already enforce it. A guarantee you cannot see elsewhere is an open question attached to the finding, not a reason to withhold it.
  • Check that a suggested fix direction is feasible, but do not edit code in review mode.

Respond To Feedback

  1. Check each comment against the code: is the problem real, and is it inside the reviewed change? Read references/judging-findings.md before dismissing or accepting comments from a person, bot, or another model.
  2. Sort each one: fix; decline with evidence (file, line, test, or documentation); needs clarification; or out of scope, recorded but not fixed now. Order the fixes with the must-fix and consider buckets in references/loop.md.
  3. Ask about unclear comments first; hold the edits that depend on them and continue with the rest.
  4. Fix in severity order, add a regression test for behavior findings, and verify with rumo-verify.
  5. Reply per comment with what changed or why it did not. Skip blanket thanks and agreement.
  6. Do not post replies, resolve threads, or request another review on the hosting platform unless the user asks.

Report

Findings first, by severity:

  • P0: immediate security, data-loss, or system-wide failure risk.
  • P1: required behavior broken or a likely production failure.
  • P2: material correctness, compatibility, lifecycle, or test gap.
  • P3: non-blocking clarity or maintainability; include only when useful.

Each finding names the repository, file and line, the consequence, the triggering condition, and the evidence. Then open questions and assumptions, then a short scope and verification note. If nothing actionable turned up, say so and name the runtime, platform, deployment, or field boundaries that remain untested.

When the user did not ask for other models but the change touches authorization, money, durable data, concurrency, a public interface, or deployment scripts, read When To Run One in references/panel.md before finishing. If its conditions hold, end the report with the one-line proposal it describes; launch nothing from here.

A finding that can be acted on:

P1 services/profile.py:54 - updating the email commits to the database but leaves the cached profile in place.
Trigger: a user changes their email and a password reset is requested within the 10-minute cache TTL.
Consequence: the reset link goes to the old address.
Evidence: line 54 commits the row; nothing deletes profile:{id}, which get_profile (line 21) reads before the database.

Not a finding: "Consider more error handling; the code could be cleaner; tests look fine." It names no location, trigger, or consequence, so nobody can verify or fix it.

Shortcuts And Rebuttals

Tempting shortcutWhy it fails
"The tests pass, so it's fine."Check whether the tests touch the changed route at all.
"I'll mention this old problem too."Findings outside the change bury the ones that matter.
"Probably main is the base."A wrong base reviews the wrong diff; confirm it.
"Quick fix while reviewing."Review mode is read-only unless the user asked for the loop or for responding to feedback.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.