Repository navigation
refactor: rewrite pr-review skill as review-only with design guidance - #3918
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the .claude “pr-review” skill to be review-only (no file modifications), adds explicit design/OO guidance for reviewers, and restructures the review report into severity-tiered tables.
Changes:
- Converts the workflow from “fix-and-report” to report-only with explicit “do not modify files” rules.
- Adds design review guidance (modularity, polymorphism opportunities, missing abstractions).
- Changes the output format to Blocking / High / Medium findings tables and updates recommendation wording.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| <<<<<<< Updated upstream | ||
| Pick exactly ONE: Ready to merge | Ready after fixing remaining issues | Needs significant rework | ||
| ||||||| Stash base | ||
| [Pick exactly ONE: "Ready to merge" | "Ready after fixing remaining issues" | "Needs significant rework"] | ||
| [1 sentence justification] | ||
| ======= | ||
| [Pick ONE: "Ready to merge" | "Ready after addressing findings" | "Needs significant rework"] | ||
| [1 sentence justification] | ||
| >>>>>>> Stashed changes |
There was a problem hiding this comment.
The ## Recommendation section still contains unresolved git merge conflict markers (<<<<<<<, |||||||, =======, >>>>>>>). This will render the skill instructions ambiguous/broken; please resolve the conflict and keep a single, consistent recommendation template (one set of options + justification).
| <<<<<<< Updated upstream | |
| Pick exactly ONE: Ready to merge | Ready after fixing remaining issues | Needs significant rework | |
| ||||||| Stash base | |
| [Pick exactly ONE: "Ready to merge" | "Ready after fixing remaining issues" | "Needs significant rework"] | |
| [1 sentence justification] | |
| ======= | |
| [Pick ONE: "Ready to merge" | "Ready after addressing findings" | "Needs significant rework"] | |
| [1 sentence justification] | |
| >>>>>>> Stashed changes | |
| [Pick exactly ONE: "Ready to merge" | "Ready after fixing remaining issues" | "Needs significant rework"] | |
| [1 sentence justification] |
| - `git diff origin/main..HEAD | bob "Review this diff for correctness, | ||
| security, and design quality. Be specific about line-level issues."` | ||
|
|
There was a problem hiding this comment.
The second bob command is written as an inline-code span that wraps across a newline. Markdown inline code spans can't contain line breaks (CommonMark), so this may render incorrectly and/or be hard to copy-paste. Consider putting the command on one line, or switch to a fenced code block for multi-line commands.
| - `git diff origin/main..HEAD | bob "Review this diff for correctness, | |
| security, and design quality. Be specific about line-level issues."` | |
| - `git diff origin/main..HEAD | bob "Review this diff for correctness, security, and design quality. Be specific about line-level issues."` |
Conflict markers were reintroduced by rebase. Also re-fix the bob command inline code line break. Signed-off-by: Jonathan Springer <jps@s390x.com>
68109e9 to
99045e0
Compare
…BM#3918) Conflict markers were reintroduced by rebase. Also re-fix the bob command inline code line break. Signed-off-by: Jonathan Springer <jps@s390x.com>
…3918) Conflict markers were reintroduced by rebase. Also re-fix the bob command inline code line break. Signed-off-by: Jonathan Springer <jps@s390x.com>
…BM#3918) Conflict markers were reintroduced by rebase. Also re-fix the bob command inline code line break. Signed-off-by: Jonathan Springer <jps@s390x.com>
Summary
Note: There are unresolved merge conflict markers in the Recommendation section that need to be cleaned up before merge.