Back to Qwen Code

Prepare PR

.qwen/skills/prepare-pr/SKILL.md

0.19.61.7 KB
Original Source

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.