revdiff for pi

revdiff for pi

This skill is specific to the pi harness. Use the revdiff pi extension for interactive review sessions.

Agent usage

Call the revdiff_review tool only when the user explicitly asks for revdiff, an interactive annotation pass, or captured revdiff annotations. Do not call it for ordinary autonomous requests like "review the code", "review my changes", or "review the diff"; handle those by inspecting the code directly. Do not tell the user to run /revdiff; slash commands are user-invoked only.

When the user invokes /skill:revdiff <input>, treat <input> as a request to launch revdiff unless it is clearly a usage/configuration question or an existing-history request. First figure out the concrete reference point(s) or file target the user asked for, then call revdiff_review. Do not stop after printing the resolved ref.

Reference resolution rules:

• Accept natural language. Resolve the user's requested target to concrete revdiff args before launching.
• If the request identifies another working directory (for example in ~/source/repo), use that directory for any git/ref/path resolution, omit that directory phrase from the revdiff args, and pass the directory as the revdiff_review tool's cwd parameter.
• For natural-language commit-count requests, use two refs: prev commit, previous commit, last commit → HEAD~1 HEAD; head-3, head 3, previous 3 commits, last 3 commits → HEAD~3 HEAD.
• For tag requests, resolve the actual tag first. last tag or latest tag → run git describe --tags --abbrev=0, then pass that tag as args.
• For date requests, resolve the commit first. Examples: 2 weeks ago, yesterday, last Friday → run git rev-list -1 --before=<phrase> HEAD, then pass the resulting commit hash as args.
• For file targets, use args: "--only <path>".
• For all-files requests, map excludes explicitly. Example: all files exclude vendor and dist → args: "--all-files --exclude=vendor --exclude=dist".
• For explicit refs, ranges, flags, or two-ref requests, pass them through as revdiff args.
• If the requested natural language target cannot be resolved, say what failed and ask for a concrete ref/path. Do not guess silently.

Tool examples:

• No args: smart detection, same default target as /revdiff
• args: "main": review the current branch against main
• args: "--staged": review staged changes
• args: "--untracked": review untracked files with working-tree changes
• args: "--only README.md": review one standalone file
• args: "--all-files --exclude vendor": review all tracked files except vendor
• args: "--no-tree": review with the file tree pane hidden
• args: "--filter-unreviewed": show only files not marked reviewed
• args: "--page-overlap=2": keep 2 lines from the previous screen when paging
• args: "--start-at-change": position the cursor on the first changed line
• args: "--cross-file-motion": let cursor motion continue into adjacent files
• args: "--description='why this refactor matters' main": include review context in the info popup
• args: "--description-file=/tmp/revdiff-desc.md main": include longer markdown review context
• args: "--annotations=/tmp/revdiff-review.md main": preload in-session review notes
• args: "main", cwd: "~/source/repo": run revdiff from a specific working directory when the session was started elsewhere.