Skip to content

Commit c8898bc

Browse files
committed
docs(skills): merge PRs through the merge queue
`gh pr merge --squash --body-file` merges directly. Under a merge queue the queue builds the squash commit itself from the repository's settings (PR title plus commit messages), so a custom body, and the Co-authored-by trailer it carried for issue reporters, would be lost. The trailer now goes on a commit in the PR instead.
1 parent 5ed38b0 commit c8898bc

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎.agents/skills/create-pr/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ A PR is one reviewable responsibility and may hold several atomic commits. A bra
1515
2. Push and open the PR — `references/open-pr.md`. A squash merge writes the PR title as the commit subject on `main`, so CI holds the title to the same Conventional Commit scope rules the `commit` skill describes.
1616
3. Request and handle AI review — `references/ai-review.md`, with the `gh` reply and thread-state calls in `references/gh-review.md`.
1717
4. Watch CI after opening and after every push with `gh pr checks`. Read the failing step logs and annotations rather than the summary, then use the `fix-ci` skill for the fix, and ask the bots for another pass if they do not rerun on their own.
18-
5. Merge only when the user explicitly asks and the conditions below hold: `gh pr merge <pr> --squash --delete-branch`. Squash is the repository's normal flow. When the PR fixes an issue someone else reported, add that reporter to the squash commit as `Co-authored-by`, using their noreply address `<id>+<login>@users.noreply.github.com` (`gh api users/<login> --jq .id`). Pass it with `--body-file`, which replaces the default squash body, so keep the trailers that body would have carried.
18+
5. Merge only when the user explicitly asks and the conditions below hold: `gh pr merge <pr>` adds the PR to `main`'s merge queue, which squashes it; pass no merge-method or `--body-file` flags. When the PR fixes an issue someone else reported, credit that reporter with a `Co-authored-by` trailer on one of the PR's commits before queuing, using their noreply address `<id>+<login>@users.noreply.github.com` (`gh api users/<login> --jq .id`): the queue builds the squash body from the commit messages.
1919
6. After merging, reply on each linked issue and on any original contributor PR it superseded. For a branch offered without a PR, reply where it was offered. Say what landed and in which PR, and, when it changes the published package, the release that shipped it or that it ships with the next one. Do this in particular when someone pinged or offered a branch and got no answer.
2020

2121
## Ready means

0 commit comments

Comments
 (0)