| name | review-walk |
| description | Interactive chunk-by-chunk code review using jj. |
Review Walk (Interactive)
Based on Ben Gesoff's review workflow.
Workflow
Step 1: Set up
jj duplicate <target>
jj edit <duplicated-change-id>
jj new --no-edit --insert-before @ -m 'review: <description>'
Note both IDs:
- Review commit (
@-) — accumulates approved code
- Duplicate (
@) — unreviewed diff
Step 2: Chunk the diff
jj diff --stat
jj diff
jj log -r '@' -T 'description' --no-graph
Group into logical chunks by: semantic concern, dependency order, file proximity, risk level. Present the plan, let the user adjust.
Step 3: Walk through chunks
For each chunk:
- Read the full files, show the diffs (
jj diff -- <paths>)
- Summarize changes, flag issues (bugs, design concerns, edge cases)
- Ask the user to approve, edit, flag, or skip
On approval:
VISUAL=true jj squash --from @ --to @- -- <file1> <file2>
jj squash -i
Show progress:
jj diff --stat
jj show @- --stat
Step 4: Finish
jj interdiff --from <original-change-id> --to @-
Produce summary with: findings, changes made, approved chunks, unreviewed items, verdict.
Teardown:
jj abandon --from @- --to @
jj abandon <original-change-id>
jj abandon @
Pausing
jj edit main
jj edit <duplicate-id>
Usage
/skill:review-walk # current change
/skill:review-walk main # bookmark
/skill:review-walk kowqznzo # change ID
/skill:review-walk abc::def # range