--- name: review-pr description: Review-only GitHub pull request analysis with the gh CLI. Use when asked to review a PR, provide structured feedback, or assess readiness to land. Do not merge, push, or make code changes you intend to keep. --- # Review PR ## Overview Perform a thorough review-only PR assessment and return a structured recommendation on readiness for /preparepr. ## Inputs - Ask for PR number or URL. - If missing, always ask. Never auto-detect from conversation. - If ambiguous, ask. ## Safety - Never push to `main` or `origin/main`, not during review, not ever. - Do not run `git push` at all during review. Treat review as read only. - Do not stop or kill the gateway. Do not run gateway stop commands. Do not kill processes on port 18792. ## Execution Rule - Execute the workflow. Do not stop after printing the TODO checklist. - If delegating, require the delegate to run commands and capture outputs, not a plan. ## Known Failure Modes - If you see "fatal: not a git repository", you are in the wrong directory. Use `~/openclaw`. - Do not stop after printing the checklist. That is not completion. ## Writing Style for Output - Write casual and direct. - Avoid em dashes and en dashes. Use commas or separate sentences. ## Completion Criteria - Run the commands in the worktree and inspect the PR directly. - Produce the structured review sections A through J. - Save the full review to `.local/review.md` inside the worktree. ## First: Create a TODO Checklist Create a checklist of all review steps, print it, then continue and execute the commands. ## Setup: Use a Worktree Use an isolated worktree for all review work. ```sh cd ~/Development/openclaw # Sanity: confirm you are in the repo git rev-parse --show-toplevel WORKTREE_DIR=".worktrees/pr-" git fetch origin main # Reuse existing worktree if it exists, otherwise create new if [ -d "$WORKTREE_DIR" ]; then cd "$WORKTREE_DIR" git checkout temp/pr- 2>/dev/null || git checkout -b temp/pr- git fetch origin main git reset --hard origin/main else git worktree add "$WORKTREE_DIR" -b temp/pr- origin/main cd "$WORKTREE_DIR" fi # Create local scratch space that persists across /reviewpr to /preparepr to /mergepr mkdir -p .local ``` Run all commands inside the worktree directory. Start on `origin/main` so you can check for existing implementations before looking at PR code. ## Steps 1. Identify PR meta and context ```sh gh pr view --json number,title,state,isDraft,author,baseRefName,headRefName,headRepository,url,body,labels,assignees,reviewRequests,files,additions,deletions --jq '{number,title,url,state,isDraft,author:.author.login,base:.baseRefName,head:.headRefName,headRepo:.headRepository.nameWithOwner,additions,deletions,files:.files|length,body}' ``` 2. Check if this already exists in main before looking at the PR branch - Identify the core feature or fix from the PR title and description. - Search for existing implementations using keywords from the PR title, changed file paths, and function or component names from the diff. ```sh # Use keywords from the PR title and changed files rg -n "" -S src packages apps ui || true rg -n "" -S src packages apps ui || true git log --oneline --all --grep="" | head -20 ``` If it already exists, call it out as a BLOCKER or at least IMPORTANT. 3. Claim the PR Assign yourself so others know someone is reviewing. Skip if the PR looks like spam or is a draft you plan to recommend closing. ```sh gh_user=$(gh api user --jq .login) gh pr edit --add-assignee "$gh_user" ``` 4. Read the PR description carefully Use the body from step 1. Summarize goal, scope, and missing context. 5. Read the diff thoroughly Minimum: ```sh gh pr diff ``` If you need full code context locally, fetch the PR head to a local ref and diff it. Do not create a merge commit. ```sh git fetch origin pull//head:pr- # Show changes without modifying the working tree git diff --stat origin/main..pr- git diff origin/main..pr- ``` If you want to browse the PR version of files directly, temporarily check out `pr-` in the worktree. Do not commit or push. Return to `temp/pr-` and reset to `origin/main` afterward. ```sh # Use only if needed # git checkout pr- # ...inspect files... git checkout temp/pr- git reset --hard origin/main ``` 6. Validate the change is needed and valuable Be honest. Call out low value AI slop. 7. Evaluate implementation quality Review correctness, design, performance, and ergonomics. 8. Perform a security review Assume OpenClaw subagents run with full disk access, including git, gh, and shell. Check auth, input validation, secrets, dependencies, tool safety, and privacy. 9. Review tests and verification Identify what exists, what is missing, and what would be a minimal regression test. 10. Check docs Check if the PR touches code with related documentation such as README, docs, inline API docs, or config examples. - If docs exist for the changed area and the PR does not update them, flag as IMPORTANT. - If the PR adds a new feature or config option with no docs, flag as IMPORTANT. - If the change is purely internal with no user-facing impact, skip this. 11. Check changelog Check if `CHANGELOG.md` exists and whether the PR warrants an entry. - If the project has a changelog and the PR is user-facing, flag missing entry as IMPORTANT. - Leave the change for /preparepr, only flag it here. 12. Answer the key question Decide if /preparepr can fix issues or the contributor must update the PR. 13. Save findings to the worktree Write the full structured review sections A through J to `.local/review.md`. Create or overwrite the file and verify it exists and is non-empty. ```sh ls -la .local/review.md wc -l .local/review.md ``` 14. Output the structured review Produce a review that matches what you saved to `.local/review.md`. A) TL;DR recommendation - One of: READY FOR /preparepr | NEEDS WORK | NEEDS DISCUSSION | NOT USEFUL (CLOSE) - 1 to 3 sentences. B) What changed C) What is good D) Security findings E) Concerns or questions (actionable) - Numbered list. - Mark each item as BLOCKER, IMPORTANT, or NIT. - For each, point to file or area and propose a concrete fix. F) Tests G) Docs status - State if related docs are up to date, missing, or not applicable. H) Changelog - State if `CHANGELOG.md` needs an entry and which category. I) Follow ups (optional) J) Suggested PR comment (optional) ## Guardrails - Worktree only. - Do not delete the worktree after review. - Review only, do not merge, do not push.

review-pr

Install this skill

Comments