Comprehensive Review Pr Enhance

What it does

This skill analyzes git diffs to generate reviewer-friendly pull request (PR) descriptions and checklists. It categorizes changes into areas like source, test, config, docs, and build, providing a structured summary of modifications. The skill also flags potential risks and suggests splitting large PRs for better manageability.

When to use it

• You need to transform a git diff into a well-structured pull request description.
• The diff is substantial, requiring explicit structure instead of a brief summary for reviewers.
• You want a PR summary including change categories, risk assessments, testing notes, and a review checklist.
• When a pull request exceeds 20 files or 1000 lines, prompting the need to split it into smaller features.

Key capabilities

• Categorizes changes within a git diff (source, test, config, docs, build, styles).
• Generates a PR description template with sections for Summary, Changes, Why, Testing, and Risks & Rollback.
• Creates a review checklist based on the file categories present in the diff.
• Flags breaking changes, security-sensitive files, or large diffs.
• Suggests splitting large pull requests by feature area using git checkout and git cherry-pick.

Example prompts

• "Analyze this git diff and generate a PR description."
• "Create a review checklist for these changes."
• “This is the output of git diff <base>...HEAD --stat, please create a pull request summary.”

Tips & gotchas

• The skill requires the input of a git diff generated using git diff <base>...HEAD --stat.
• Do not treat the output as a replacement for environment-specific validation, testing, or expert review.
• If any required information (permissions, safety boundaries, success criteria) is missing, stop and ask for clarification.