Home/Git & GitHub/pr-commit-workflow

pr-commit-workflow

Safe
Git & GitHub

This skill should be used when creating commits or pull requests.

SKILL.md

# PR + Commit Workflow ## Overview Enforce a high-signal commit workflow and a human-written PR format. Keep global process rules as source of truth and make PRs reviewable by humans and agents. ## Workflow Decision Tree - If the task is about commits only, follow `references/workflow-commit.md`. - If the task involves PR creation or PR updates, follow `references/workflow-pr.md`. ## Global Rules - If the repo has `AGENTS.md` or `docs/agents/PROCESS.md`, read it for repo-specific rules. - Require user-supplied, human-written intent for every PR. Never generate or paraphrase this text. - Use `/tmp` for PR body drafts and `gh pr edit --body-file` for updates. ## Commit Workflow (entry point) - Execute the steps in `references/workflow-commit.md`. - Use the message format in `references/commit-format.md`. ## PR Workflow (entry point) - Execute the steps in `references/workflow-pr.md`. - Use the template in `references/pr-human-template.md` verbatim. - Use `scripts/build_pr_body.sh` to gather environment metadata if available. ## Resources - `references/workflow-commit.md`: commit checklist and evidence expectations. - `references/workflow-pr.md`: PR creation/update flow, comment checks, and evidence rules. - `references/pr-human-template.md`: human-written PR structure (must be used as-is). - `references/commit-format.md`: commit message format and examples. - `scripts/build_pr_body.sh`: environment metadata collector for PR prompt history section.

More in Git & GitHub