name: git-pr-prep description: Prepares a Pull Request by staging changes, verifying against acceptance criteria, and creating the PR via GH CLI. Use this skill when a feature is complete and ready for review. trigger: always_on
This skill ensures that every Pull Request is descriptive, verified, and adheres to the project''s technical rigor as defined in orchestration/project_context.md and .agent/rules/directives/pr_acceptance_criteria.md.
PR Preparation Workflow
-
Staging & Intent:
- Verify you are on the correct
devor feature branch. - Stage only the files relevant to the task. Avoid staging unrelated debug logs or temporary files.
- Use the
git status -ucommand to identify untracked files that should be included. - Include test result artifacts in the commit when tests are run (for example,
TestResult.xml).
- Verify you are on the correct
-
Rigor Check:
- Self-audit the code against
pr_acceptance_criteria.md. - Ensure no
console.logor temporaryTODOcomments remain in the source. - Verify that all C# models have appropriate
[DataMember]attributes if they are part of the JSON bridge.
- Self-audit the code against
-
PR Artifact:
- Create or update the
pull_requests/pr_[id].mdfile using the provided template. - Include specific instructions for the Tester to verify the changes.
- For UI-impacting changes, include links or references to image and WebM artifacts in the PR artifact (and commit them when stored in-repo).
- Create or update the
-
GH CLI Execution:
- Run
gh pr createwith a clear title and a body that references the PR artifact or contains a concise summary of thewalkthrough.md. - Target the
mainbranch unless instructed otherwise.
- Run