sprint-reviewlisted
Install: claude install-skill rhesis-ai/rhesis
# Sprint Review
Generate a markdown changelog from GitHub PRs for sprint review meetings.
## Defaults
- **Time range**: last two weeks (14 days from today)
- **Author**: the current GitHub user -- detect automatically via `gh api user --jq .login`
Both can be overridden if the user explicitly provides a different author or date.
## Workflow
1. **Detect the current user** (unless explicitly provided):
```bash
gh api user --jq .login
```
2. **Collect PRs** using GitHub CLI (default: last 14 days):
```bash
gh pr list --author <username> --state all --search "created:>=<date>" --limit 100 \
--json number,title,state,createdAt,body,url \
| jq -r '.[] | "\(.number)|\(.title)|\(.state)|\(.createdAt)|\(.url)"'
```
3. **Fetch PR bodies** for context on what each PR does (use `--json body`).
4. **Group PRs** into two sections:
- **Features** -- new capabilities, refactors, new providers, new APIs
- **Fixes** -- bug fixes, dependency patches, config corrections, minor chores
5. **Consolidate similar PRs** under a single description when they share the same goal (e.g. two PRs making different parts of the SDK async-first).
6. **Write the markdown file** to `docs/changelog-<username>.md` using this format:
```markdown
## PR Changelog -- <username> (<start date> -- <end date>)
### Features
**Short heading**
One-to-two sentence description.
- [#<number> -- <title>](<url>)
- [#<number> -- <title>](<url>) *(open/draft if not merged)*
### Fixes
**Short heading**