Skip to content

Comments

refactor(pr-review): reduce strictness and focus on real issues#7

Merged
activadee merged 1 commit intomainfrom
OW/OW-2-fix-reduce-strictness-in-pr-review-skill-focus-on-real-issues-on
Jan 3, 2026
Merged

refactor(pr-review): reduce strictness and focus on real issues#7
activadee merged 1 commit intomainfrom
OW/OW-2-fix-reduce-strictness-in-pr-review-skill-focus-on-real-issues-on

Conversation

@activadee
Copy link
Owner

Summary

  • Review philosophy shift: PR reviews now focus on issues that represent real risks (bugs, security, stability) rather than style preferences, acting like a senior engineer in time-limited code review.
  • Context awareness: Skill now fetches prior PR comments to understand existing feedback and avoid re-flagging already-addressed issues.
  • Detailed priority guidance: Clear tables showing what IS and ISN'T worth flagging for correctness, security, stability, and maintainability with concrete examples.
  • Explicit nitpick avoidance: Comprehensive list of common low-value flags to skip (style, defensive programming, DRY without cost, subjective complexity).
  • Conservative verdict rules: request_changes only for merge-blocking issues; approve used generously for clean PRs or low-severity findings.

## Summary of Changes

### src/skills/pr-review.ts
Completely refactored the skill with:

1. **New Review Philosophy** - Framed as "Would a senior engineer in a time-limited review raise this?"

2. **Refined Review Priorities** with concrete IS/ISN'T tables:
 - Correctness: Off-by-one bugs ✓ | Type confusion without runtime impact ✗
 - Security: SQL injection ✓ | Hypothetical attack scenarios ✗
 - Stability: Race conditions ✓ | Extra defensive checks ✗
 - Maintainability: Misleading names ✓ | Naming preferences ✗

3. **Context from Prior Reviews** section:
 - Fetches existing PR comments via gh pr view --json comments,reviews
 - Creates validation todo items for previously-flagged issues
 - Acknowledges resolved feedback, only flags NEW issues

4. **Common Nitpicks to Avoid** section covering 6 items:
 - Coding style preferences
 - Defensive programming suggestions
 - DRY violations without real cost
 - Missing code comments
 - Subjective complexity concerns
 - Minor refactoring suggestions

5. **Refined Verdict Rules**:
 - request_changes only for merge-blocking issues
 - Default severity to low unless clearly higher
 - Clear severity definitions (medium = "probably causes bug", h

Attempt: att-17b28415-95f4-4a5f-b14e-8ca48c414f71
Profile: apg-70541e2b-d01c-4d50-a814-7025ac222ebe
@github-actions
Copy link
Contributor

github-actions bot commented Jan 3, 2026

AI Review Summary

Verdict: APPROVE
Commit: e495ad9

Findings

No significant issues found.

Overall Assessment

This PR significantly improves the pr-review skill by adding clear guidance on what constitutes a real issue versus a nitpick. The changes are well-structured and provide concrete examples that will help the AI focus on substantive problems. The documentation updates align perfectly with the skill changes.

@activadee activadee merged commit 379dd2c into main Jan 3, 2026
2 checks passed
@activadee activadee deleted the OW/OW-2-fix-reduce-strictness-in-pr-review-skill-focus-on-real-issues-on branch January 3, 2026 20:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant