---
name: wataru-maeda-manage-prs
description: "Create, review, and merge GitHub pull requests and publish releases using repository Git rules. Use for requests to open a PR, push and create a PR, review PRs, merge a PR, or tag a release and write release notes."
license: "MIT"
metadata:
  decimalai-skill-id: "0c5c2443-2ece-4d45-889a-58caf6bcd919"
  decimalai-version-id: "083087b2-436f-4551-b1c5-09299a333d64"
  decimalai-version: "1"
  decimalai-body-sha256: "fc7013c9518f8dd6a790b34af6dfe0feb3fdfff5d4eb10ba2b95e8821c43e078"
  decimalai-name: "wataru-maeda/manage-prs"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "code-review"
  decimalai-source: "https://app.decimal.ai/s/wataru-maeda-manage-prs@1/SKILL.md"
---
# Manage PRs

Follow [Git rules](../../../AGENTS.md#git). Work branches target `dev`. Promotion PRs go from `dev` to `stg` and from `stg` to `main`.

## Actions

| Request                          | Read                     |
| -------------------------------- | ------------------------ |
| Open a PR for the current branch | [create.md](create.md)   |
| Review one or more PRs           | [review.md](review.md)   |
| Promote `dev` → `stg` → `main`   | [promote.md](promote.md) |
| Tag and publish a release        | [release.md](release.md) |

## PR Rules

### Title

- Write `type(scope): description`, at most 70 characters. Use the types and scopes in [Commits](../../../AGENTS.md#commits).
- Squash merges use the title as the commit message.
- Title promotion PRs `chore: promote dev to stg` or `chore: release v<version>` for `stg` to `main`.

### Body

- Fill `.github/pull_request_template.md` from the actual diff and commits. Never reuse old text.
- Link related issues in Overview with `Closes #N`.
- Tick only checks that ran. Record failures and skipped checks in Notes.
- Fill Test Cases with actual results, including Maestro flows and the platforms they ran on. Remove the table when there are none.
- Remove empty sections and placeholders. Leave screenshots to the user when UI changed.

### Merge

- Merge only when asked and after required checks pass.
- Squash merge work branches into `dev`. Use merge commits for promotion and hotfix merge-back PRs ([Merge and Version](../../../AGENTS.md#merge-and-version)).
- Never pass `--subject`. GitHub titles the commit `<PR title> (#<N>)`, which links it back to the PR.
- Keep work branches. Delete them only when cleanup is requested. Never delete `dev`, `stg`, or `main`.

```bash
gh pr checks <N> --watch
gh pr merge <N> --squash                   # work branches into dev
gh pr merge <N> --merge                    # dev → stg, stg → main, hotfix merge-back
```
