| name | pr-workflow |
| description | Create and repair UniRL pull requests. Use when creating a PR, editing a PR body, responding to PR Body or Semantic Pull Request CI failures, running gh pr create, or when the user mentions PR body, pull request template, body check, title check, or pull request formatting. |
PR Workflow
Before Creating Or Updating A PR
- Read
.github/pull_request_template.md, .github/workflows/pr-body.yml, and .github/workflows/semantic-pull-request.yml from the current branch.
- Inspect the full diff against the intended base branch, not just the latest commit.
- Check for overlapping open PRs or issues when the user is asking to publish a substantive change.
- Do not include unrelated local files, generated artifacts, datasets, checkpoints, credentials, or outputs.
Title
Use the Semantic Pull Request types allowed by .github/workflows/semantic-pull-request.yml:
fix, feat, docs, test, refactor, build, ci, chore, perf, revert.
Prefer a concise title in the form type(scope): summary when a scope is helpful, otherwise type: summary.
Body
Start from .github/pull_request_template.md and fill it with reviewer-facing content.
Required by the body check:
## Summary must contain visible, non-comment text explaining what changed and why.
## Test Plan must contain visible, non-comment text with exact validation commands/jobs, or Not run; reason: ....
Recommended:
- Use
N/A for sections that do not apply.
- Mention compatibility risks for config, checkpoint, data format, API, resource, or migration changes.
- Mention AI assistance and duplicate-work checks when relevant.
- Keep the body concise; do not produce a file-by-file changelog.
Fixing PR Body Failures
If the PR Body / Validate PR body sections check fails:
- Read the failure message.
- Ensure the PR is not relying on HTML comments or untouched template examples as content.
- Add real text under
## Summary and ## Test Plan.
- Do not solve failures by weakening the workflow unless the user explicitly asked to change policy.