rocketmq-rust-pr-submitter

name	rocketmq-rust-pr-submitter
description	Use when the user asks to prepare, submit, publish, or optimize a pull request for the rocketmq-rust project, especially when the PR title or commit message must follow the `[ISSUE

RocketMQ Rust PR Submitter

Prepare RocketMQ Rust PR titles, commit messages, and bodies from .github/PULL_REQUEST_TEMPLATE.md. Connects PR to issue via [ISSUE #id] title/commit prefix and Fixes #id body line.

When to Use

• User asks to create, prepare, or publish a PR for rocketmq-rust
• PR title or commit message must follow [ISSUE #issue_id]<emoji><summary> format
• PR body must follow the repository's real PR template (not a custom format)
• Issue id is available from user request, branch name, or commit history
• Public PR titles, commit messages, and body content must be English-only

When NOT to use: Simple branch merges without a linked issue. PRs for repos that don't use the RocketMQ Rust PR template convention.

Quick Reference

Change Type	Emoji
Bug fix	🐛
Documentation	📝
Enhancement / CI / runtime audit	✨
New feature	🚀
Refactor	♻️
Tests	🧪

If unclear, default to ✨ and note the assumption.

Workflow

1. Read the PR Template

rg --hidden --files -g '*PULL_REQUEST_TEMPLATE*' -g '*pull_request_template*' -g '!**/target/**'

Expected: .github/PULL_REQUEST_TEMPLATE.md with three headings: Which Issue(s) This PR Fixes(Closes), Brief Description, How Did You Test This Change?. Remove HTML comments from the generated body. Use the checked-out template if it differs.

2. Determine Issue Id

Priority order: user request → branch name (issue-7544, fix-7544) → commit messages ([ISSUE #7544]) → prepared PR text (Fixes #7544). Normalize to numeric id. Never publish with #issue_id still present.

3. Write Title

[ISSUE #issue_id]<emoji><summary>

Do not put spaces between ], the emoji, and the summary. No extra prefixes (conventional commit, branch name). Keep the summary short and action-oriented.

Generate the summary from the actual PR change: affected subsystem, behavior fixed, test coverage added, docs updated, or refactor performed. Do not use sequencing-marker wording such as task 1, stage 1, phase 1, step 3, or part 4, even if the branch name, issue text, or user draft contains those words.

Write the title and commit-message summary in English only. The required emoji is allowed; Chinese or other non-English prose is not allowed.

If creating a commit as part of the PR workflow, use the exact same compact format for the commit message:

[ISSUE #issue_id]<emoji><summary>

4. Write Body

### Which Issue(s) This PR Fixes(Closes)

- Fixes #issue_id

### Brief Description

<Changed modules, behavior, motivation. Keep focused on maintainer review.>

### How Did You Test This Change?

<Commands run and results, or honest note that validation was not run.>

Preserve template headings exactly. Keep paths repository-relative. In the test section, list commands and results; say "validation not run" honestly if applicable.

Write all public body prose in English. Repository-relative paths, code identifiers, commands, issue numbers, Markdown punctuation, and the required emoji are allowed.

5. Validate and Publish

1. Confirm branch, target branch, and issue id.
2. Validate title/body:

   python <skill-dir>/scripts/validate_pr_content.py --title "<title>" --body <body.md>
   

3. Use available GitHub tool/CLI. Create a normal ready-for-review PR — do not pass draft flags unless the user explicitly asked for a draft PR.
4. Report PR URL. If publishing unavailable, provide ready-to-submit title and body.

Common Mistakes

Mistake	Fix
Omitting emoji from title	Always include emoji between ] and summary
Leaving #issue_id placeholder	Replace with numeric id in both title and body
Creating draft PR by default	Normal ready-for-review PR unless user says "draft PR"
Claiming unrun validation passed	State "validation not run" honestly in test section
Writing PR prose in Chinese or mixed language	Rewrite the title/body in English and rerun validation
Adding spaces or extra prefixes	Only [ISSUE #id]<emoji><summary> for PR titles and commit messages
Using process labels like task 1, stage 1, or phase 1 as the summary	Replace them with a concise summary of the actual code, docs, tests, or behavior change
Wrong emoji for change type	Match to linked issue type; default to ✨

Output Format

Full prepare request:

Title:
[ISSUE #issue_id]<emoji><summary>

Body:
### Which Issue(s) This PR Fixes(Closes)
- Fixes #issue_id
...

Title only: Return candidate titles in the exact format.

Final Check

• Title matches [ISSUE #number]<emoji><summary>
• Commit message, when created, matches [ISSUE #number]<emoji><summary>
• Title and commit summary describe the actual change and do not contain sequencing markers like task 1, stage 1, or phase 1.
• Body includes three PR template headings in order with - Fixes #number
• Title/body are English-only.
• Test section doesn't claim unrun commands passed
• No local absolute paths, machine-specific roots, or non-English prose