ajmallesh
64 lines
2.7 KiB
Markdown
64 lines
2.7 KiB
Markdown
---
|
|
description: Create a PR to main branch using conventional commit style for the title
|
|
---
|
|
|
|
Create a pull request from the current branch to the `main` branch.
|
|
|
|
## Arguments
|
|
|
|
The user may provide issue numbers that this PR fixes: `$ARGUMENTS`
|
|
|
|
- If provided (e.g., `123` or `123,456`), use these issue numbers
|
|
- If not provided, check the branch name for issue numbers (e.g., `fix/123-bug` or `issue-456-feature` → extract `123` or `456`)
|
|
- If no issues are found, omit the "Closes" section
|
|
|
|
## Steps
|
|
|
|
First, analyze the current branch to understand what changes have been made:
|
|
1. Run `git log --oneline -10` to see recent commit history and understand commit style
|
|
2. Run `git log main..HEAD --oneline` to see all commits on this branch that will be included in the PR
|
|
3. Run `git diff main...HEAD --stat` to see a summary of file changes
|
|
4. Run `git branch --show-current` to get the branch name for issue detection (if no explicit issues provided)
|
|
|
|
Then generate a PR title that:
|
|
- Follows conventional commit format (e.g., `fix:`, `feat:`, `chore:`, `refactor:`)
|
|
- Is concise and accurately describes the changes
|
|
- Matches the style of recent commits in the repository
|
|
|
|
Generate a PR body with:
|
|
- A `## Summary` section using rich bullets with bold action leads
|
|
- A `Closes #X` line for each issue number (if any were provided or detected from branch name)
|
|
|
|
Each Summary bullet must follow this format:
|
|
- **Bold action phrase** (imperative verb: "Add X", "Replace Y", "Fix Z") — followed by em dash and a 1-2 sentence conceptual description of what changed and why
|
|
- Keep descriptions conceptual — no inline code references (no backticks for function/file names). The diff shows the code
|
|
- Use 2-5 bullets, scaling with PR size. Group related changes into single bullets rather than listing every file touched
|
|
|
|
Example:
|
|
```
|
|
## Summary
|
|
|
|
- **Add preflight validation** — validates repo path, config, and credentials before agent execution. Fails fast with actionable errors
|
|
- **Replace error strings** — pipe-delimited segments rendered as multi-line blocks with phase context, type, message, and remediation hint
|
|
- **Add error classification** — new error codes for repo, auth, and billing failures with proper retry classification
|
|
```
|
|
|
|
Finally, create the PR using the gh CLI:
|
|
```
|
|
gh pr create --base main --title "<generated title>" --body "$(cat <<'EOF'
|
|
## Summary
|
|
<rich bullets>
|
|
|
|
Closes #<issue1>
|
|
Closes #<issue2>
|
|
EOF
|
|
)"
|
|
```
|
|
|
|
Note: Omit the "Closes" lines entirely if no issues are associated with this PR.
|
|
|
|
IMPORTANT:
|
|
- Do NOT include any Claude Code attribution in the PR
|
|
- Use the conventional commit prefix that best matches the changes (fix, feat, chore, refactor, docs, etc.)
|
|
- The `Closes #X` syntax will automatically close the referenced issues when the PR is merged
|