Loading...
Loading...
Create a PR for this branch. ALWAYS links related issues and uses closing keywords to auto-close them on merge.
npx skill4agent add cygnusfear/agent-skills create-prCloses #XFixes #X# Check current branch name for issue hints
git branch --show-current
# Search for related issues
gh issue list --search "relevant keywords"
# View specific issue
gh issue view <number># See what changed
git log main..HEAD --oneline
git diff main..HEAD --stat
# Get commit messages for context
git log main..HEAD --format="%s%n%b"writing-clearly-and-conciselygh pr create --title "[type]: [emoji] [description]" --body "$(cat <<'EOF'
[Two-sentence summary of what and why]
## Key Changes
- [Change 1]
- [Change 2]
## Related Issues
**Closes:**
- Closes #X - [brief description of what's fixed]
- Closes #Y - [brief description]
**Related (not closing):**
- Related to #Z - [why related]
- See also #W - [context]
## Testing
- [How it was tested]
## Files Changed
- [List key files]
EOF
)"| Keyword | Example | Effect |
|---|---|---|
| | Closes issue when PR merges |
| | Closes issue when PR merges |
| | Closes issue when PR merges |
Closes #X - brief description# Verify the PR shows linked issues
gh pr view <number> --json closingIssuesReferences
# Check the issue shows the PR link
gh issue view <number>[Two-sentence summary: what changed and why it was needed]
## Key Changes
- [Most important change]
- [Second important change]
- [Third important change]
## Related Issues
**Closes:**
- Closes #X - [what requirement this addresses]
- Fixes #Y - [what bug this fixes]
**Related:**
- Related to #Z - [provides context but doesn't close]
## Testing
- [Manual testing performed]
- [Automated tests added/passing]
## Architectural Impact
[If significant: explain system-wide effects]
## Files Changed
- `path/to/file1.ts` - [what changed]
- `path/to/file2.ts` - [what changed]❌ WRONG:
gh pr create --title "Fix bug" --body "Fixed the thing"
❌ WRONG:
"Related: #123" (no closing keyword, issue won't close)
❌ WRONG:
No mention of any issues at all
✅ CORRECT:
gh pr create --title "fix: 🔧 Resolve auth token expiration" --body "
Fixes session timeout by implementing token refresh.
## Related Issues
- Closes #123 - Auth token expires incorrectly
- Closes #124 - Users logged out unexpectedly
- Related to #100 - Auth system overhaul (partial)
"| PR Type | Diagram Use |
|---|---|
| Bug fix | Before/after flow showing fix |
| New feature | User journey or data flow |
| Refactor | Component dependency changes |
| API changes | Request/response sequence |
## Key Changes
Added token refresh flow when session expires.
### New Authentication Flow
```mermaid
sequenceDiagram
participant C as Client
participant A as Auth Service
participant D as Database
C->>A: Request with expired token
A-->>C: 401 Token Expired
C->>A: POST /refresh with refresh_token
A->>D: Validate refresh token
D-->>A: Token valid
A-->>C: New access token
C->>A: Retry original request
A-->>C: 200 Success
```
## Related Issues
- Closes #123 - Token expiration handling## Flow changes: flowchart
## API interactions: sequenceDiagram
## State machines: stateDiagram-v2
## Data models: erDiagramgh issue list --search "keywords"Closes #XFixes #Xgh pr view --json closingIssuesReferences