creating-android-pull-request
Installation
SKILL.md
Create Pull Request
PR Title Format
[PM-XXXXX] <type>: <short imperative summary>
Examples:
[PM-12345] feat: Add autofill support for passkeys[PM-12345] fix: Resolve crash during vault sync[PM-12345] refactor: Simplify authentication flow
Rules:
- Include Jira ticket prefix
- Keep under 70 characters total
- Use imperative mood in the summary
Type keywords (triggers automatic t: label via CI):
Invoke the labeling-android-changes skill for the full type keyword table and selection guidance.
PR Body Template
IMPORTANT: Always follow the repo's PR template at .github/PULL_REQUEST_TEMPLATE.md. Delete the Screenshots section entirely if there are no UI changes.
Pre-PR Checklist
- All tests pass: Run
./gradlew app:testStandardDebugUnitTest(and other affected modules) - Lint clean: Run
./gradlew detekt - Self-review done: Use
perform-android-preflight-checklistskill - No unintended changes: Check
git diff origin/main...HEADfor unexpected files - Branch up to date: Rebase on
mainif needed
Creating the PR
# Ensure branch is pushed
git push -u origin <branch-name>
# Create PR as draft by default (body follows .github/PULL_REQUEST_TEMPLATE.md)
gh pr create --draft --title "[PM-XXXXX] feat: Short summary" --body "<fill in from PR template>"
Default to draft PRs. Only create a non-draft (ready for review) PR if the user explicitly requests it.
AI Review Label
Before running gh pr create, always use the AskUserQuestion tool to ask whether to add an AI review label:
- Question: "Would you like to add an AI review label to this PR?"
- Options:
ai-review-vnext,ai-review,No label
If the user selects a label, include it via the --label flag:
gh pr create --draft --label "ai-review-vnext" --title "..." --body "..."
Base Branch
- Default target:
main - Check with team if targeting a feature branch instead