prepare-pr git:20260702.e1e99f7A

Immutable. This exact content is served forever at /api/v1/blob/9c2e522b1cad98c2.

---
name: prepare-pr
description: Prepare GitHub pull request title and body files from the current branch diff, especially for non-interactive CI/autofix flows that must follow the repository PR template without pushing or creating the PR.
argument-hint: '<output-dir> [issue-number]'
allowedTools:
  - read_file
  - write_file
  - grep_search
  - glob
  - run_shell_command
---

# Prepare PR

Create PR metadata files only. Do not push, comment, or run `gh pr create`.

## Inputs

- Output directory: default `/tmp/autofix`
- Issue number: from the argument, `ISSUE`, or the current branch name

## Required Outputs

Write:

- `<output-dir>/pr-title.txt`
- `<output-dir>/pr-body.md`

## Workflow

1. Inspect the current branch diff with `git diff origin/main...HEAD` and recent commit message with `git log -1 --pretty=%B`.
2. Read `<output-dir>/e2e-report.md` if it exists.
3. Read `.github/pull_request_template.md`.
4. Write a Conventional Commit style title to `pr-title.txt`.
5. Fill the repository PR template in place and write it to `pr-body.md`.

## PR Body Rules

- Keep every template section heading exactly as written.
- Do not replace template headings with `Summary`, `Root Cause`, `Fix`, or `Tests`.
- Use prose for motivation and changes; avoid file-by-file implementation notes unless needed for reviewer clarity.
- Include a useful Reviewer Test Plan with concrete behavior to verify.
- Fill `Evidence (Before & After)` with concise before/after behavior or `N/A` for non-UI changes.
- Mark tested OS rows honestly. For Linux-only CI verification, mark Linux tested and macOS/Windows not tested.
- Include risk, out-of-scope, and breaking-change notes.
- Add `Fixes #<issue-number>` under `Linked Issues` when an issue number is known.
- Keep the `<details><summary>中文说明</summary>` section and translate the English body into Chinese there.
- Do not hard-wrap paragraphs or list items at a fixed column width.

## Common Mistakes

- Writing a free-form PR body instead of filling the template.
- Claiming checks passed when they were not run.
- Omitting the Chinese details section.
- Using closing keywords for unrelated issues.