RocketMQ Rust Issue Generator
Generate GitHub issue drafts from the repository's real issue forms. Template-driven — do not output a fixed canonical body unless the selected form has those fields.
When the repository owner or maintainer wants to prepare issues for new contributors to claim, also use rocketmq-rust-good-first-issue for concrete file checklists, newcomer labels, and optional per-crate sub-issues.
When to Use
- User asks to create, draft, or publish a GitHub issue for rocketmq-rust
- User's rough draft mentions generic sections or non-existent template names — must be converted to real forms
- Issue must preserve exact template title prefix (including emoji), label set, and field order
- Local filesystem paths must be audited and removed before publishing
- Public issue titles and body content must be English-only
When NOT to use: Non-rocketmq-rust repositories, pure discussion/questions that should not become GitHub issues, or requests where the user explicitly says not to apply issue templates.
Quick Reference
| Intent |
Template |
Title Prefix |
| Bug, panic, incorrect behavior |
bug_report.yml |
[Bug🐛] |
| Missing/improved test coverage |
unit_test.yml |
[Test🧪] |
| Docs, README, examples, comments |
doc.yml |
[Doc📝] |
| New broker/client/store/dashboard capability |
feature_request.yml |
[Feature🚀] |
| CI gate, runtime audit, ergonomics |
enhancement_request.yml |
[Enhancement✨] |
| Internal restructure, module cleanup |
refactor.yml |
[Refactor♻️] |
Select the narrowest template. When ambiguous, state tradeoff and choose narrowest (e.g., "add consume queue recovery tests" → unit test, not feature). Verify files exist in checkout — don't assume draft-only names like architecture.yml.
Workflow
1. Locate Templates
rg --hidden --files -g '.github/ISSUE_TEMPLATE/**' -g 'ISSUE_TEMPLATE/**' -g '!**/target/**'
Read config.yml for policy. For each form, extract name, title prefix (with emoji), labels, every body item in order, and validations.required. For Markdown forms, preserve heading order and checklist meaning.
If terminal output corrupts emoji or symbols, do not copy from the noisy terminal. Re-read the template files as UTF-8 and use the exact checked-out title: value.
2. Fill The Issue
Title: <template title prefix including emoji><specific summary>
Template: <filename>
Labels: <labels from template>
<issue body following template field order>
Missing info:
- <None, or concise missing confirmations/data>
Rules:
- Every template field, in order. Required fields must have content or be listed as missing.
- Use
Not applicable only when a field clearly does not apply.
- Never mark prerequisite/contribution checkboxes complete unless confirmed or actually performed.
- Generate the title summary from the actual bug, feature, test gap, doc change, or refactor. Do not use sequencing-marker wording such as
task 1, stage 1, phase 1, step 3, or part 4, even when the user's rough draft contains those words.
- Tasks must be actionable: name affected modules, expected behavior, tests, and validation commands.
- Use RocketMQ domain vocabulary (broker, namesrv, commitlog, consume queue, Tokio runtime, etc.) only where it helps the form.
- Write all public issue title/body text in English. Repository-relative paths, code identifiers, commands, issue numbers, Markdown punctuation, and the template emoji are allowed; Chinese or other non-English prose is not allowed.
3. Remove Local Paths
Strip Windows/Unix home paths, file:// links, user-home env vars, local screenshot/temp/IDE paths. Rewrite to repository-relative paths or generic descriptions ("local broker log").
Audit before publishing, including the title when available:
python <skill-dir>/scripts/audit_issue_paths.py --title "<title>" <draft.md>
Fix every finding.
4. Publish
- Confirm required fields complete and path audit passes.
- Use available GitHub tool/CLI with template labels.
- Report created issue URL. If publishing unavailable, return ready-to-submit draft.
Common Mistakes
| Mistake |
Fix |
| Dropping the template emoji from title |
Copy title: prefix exactly from the template file |
Inventing template names (e.g., architecture.yml) |
Verify files exist in checkout; use only real filenames |
| Marking checkboxes complete without confirmation |
List unconfirmed items as missing |
| Leaving a local Windows user path in draft |
Run audit_issue_paths.py before finalizing |
| Writing issue prose in Chinese or mixed language |
Rewrite the title/body in English and rerun the audit |
Using process labels like task 1, stage 1, or phase 1 in the title |
Replace them with a concise summary of the actual change or problem |
| Using feature_request for test-only work |
Unit test additions → unit_test.yml |
| Copying mojibake emoji from terminal |
Re-read file with UTF-8 or use file content directly |
Output Modes
- Title only: Return candidate titles with exact template prefix.
- Full draft: Title, template, labels, body in template order, missing info section.
- Draft conversion: Normalize user's rough draft to real form; drop sections not in the selected template.
Final Check
- Selected template filename is real in the current checkout.
- Title keeps the selected template prefix exactly, including emoji.
- Title summary describes the actual change/problem and does not contain sequencing markers like
task 1, stage 1, or phase 1.
- Labels match the selected template.
- Body fields appear in template order.
- Required fields have content or are listed under
Missing info.
- Title/body are English-only.
- Checkboxes are not falsely marked complete.
- Path and English audit passes with no local absolute paths, machine-specific roots, or non-English prose.
1---2name: rocketmq-rust-issue-generator3description: Use when the user asks to create, draft, prepare, or publish a GitHub issue for the rocketmq-rust project — bugs, features, enhancements, refactors, docs, unit tests, CI, runtime-model, broker, namesrv, client, store, dashboard, architecture, or performance work — especially when the issue must preserve real ISSUE_TEMPLATE fields, exact title prefix including template emoji, aligned labels, actionable engineering tasks, and no leaked local filesystem paths.4---56# RocketMQ Rust Issue Generator78Generate GitHub issue drafts from the repository's real issue forms. Template-driven — do not output a fixed canonical body unless the selected form has those fields.910When the repository owner or maintainer wants to prepare issues for new contributors to claim, also use [rocketmq-rust-good-first-issue](../rocketmq-rust-good-first-issue/SKILL.md) for concrete file checklists, newcomer labels, and optional per-crate sub-issues.1112## When to Use1314- User asks to create, draft, or publish a GitHub issue for rocketmq-rust15- User's rough draft mentions generic sections or non-existent template names — must be converted to real forms16- Issue must preserve exact template title prefix (including emoji), label set, and field order17- Local filesystem paths must be audited and removed before publishing18- Public issue titles and body content must be English-only1920**When NOT to use:** Non-rocketmq-rust repositories, pure discussion/questions that should not become GitHub issues, or requests where the user explicitly says not to apply issue templates.2122## Quick Reference2324| Intent | Template | Title Prefix |25|--------|----------|-------------|26| Bug, panic, incorrect behavior | `bug_report.yml` | `[Bug🐛] ` |27| Missing/improved test coverage | `unit_test.yml` | `[Test🧪] ` |28| Docs, README, examples, comments | `doc.yml` | `[Doc📝] ` |29| New broker/client/store/dashboard capability | `feature_request.yml` | `[Feature🚀] ` |30| CI gate, runtime audit, ergonomics | `enhancement_request.yml` | `[Enhancement✨] ` |31| Internal restructure, module cleanup | `refactor.yml` | `[Refactor♻️] ` |3233Select the narrowest template. When ambiguous, state tradeoff and choose narrowest (e.g., "add consume queue recovery tests" → unit test, not feature). Verify files exist in checkout — don't assume draft-only names like `architecture.yml`.3435## Workflow3637### 1. Locate Templates38```bash39rg --hidden --files -g '.github/ISSUE_TEMPLATE/**' -g 'ISSUE_TEMPLATE/**' -g '!**/target/**'40```41Read `config.yml` for policy. For each form, extract `name`, `title` prefix (with emoji), `labels`, every `body` item in order, and `validations.required`. For Markdown forms, preserve heading order and checklist meaning.4243If terminal output corrupts emoji or symbols, do not copy from the noisy terminal. Re-read the template files as UTF-8 and use the exact checked-out `title:` value.4445### 2. Fill The Issue4647```48Title: <template title prefix including emoji><specific summary>49Template: <filename>50Labels: <labels from template>5152<issue body following template field order>5354Missing info:55- <None, or concise missing confirmations/data>56```5758Rules:59- Every template field, in order. Required fields must have content or be listed as missing.60- Use `Not applicable` only when a field clearly does not apply.61- Never mark prerequisite/contribution checkboxes complete unless confirmed or actually performed.62- Generate the title summary from the actual bug, feature, test gap, doc change, or refactor. Do not use sequencing-marker wording such as `task 1`, `stage 1`, `phase 1`, `step 3`, or `part 4`, even when the user's rough draft contains those words.63- Tasks must be actionable: name affected modules, expected behavior, tests, and validation commands.64- Use RocketMQ domain vocabulary (broker, namesrv, commitlog, consume queue, Tokio runtime, etc.) only where it helps the form.65- Write all public issue title/body text in English. Repository-relative paths, code identifiers, commands, issue numbers, Markdown punctuation, and the template emoji are allowed; Chinese or other non-English prose is not allowed.6667### 3. Remove Local Paths6869Strip Windows/Unix home paths, `file://` links, user-home env vars, local screenshot/temp/IDE paths. Rewrite to repository-relative paths or generic descriptions ("local broker log").7071Audit before publishing, including the title when available:72```bash73python <skill-dir>/scripts/audit_issue_paths.py --title "<title>" <draft.md>74```75Fix every finding.7677### 4. Publish781. Confirm required fields complete and path audit passes.792. Use available GitHub tool/CLI with template labels.803. Report created issue URL. If publishing unavailable, return ready-to-submit draft.8182## Common Mistakes8384| Mistake | Fix |85|---------|-----|86| Dropping the template emoji from title | Copy `title:` prefix exactly from the template file |87| Inventing template names (e.g., `architecture.yml`) | Verify files exist in checkout; use only real filenames |88| Marking checkboxes complete without confirmation | List unconfirmed items as missing |89| Leaving a local Windows user path in draft | Run `audit_issue_paths.py` before finalizing |90| Writing issue prose in Chinese or mixed language | Rewrite the title/body in English and rerun the audit |91| Using process labels like `task 1`, `stage 1`, or `phase 1` in the title | Replace them with a concise summary of the actual change or problem |92| Using feature_request for test-only work | Unit test additions → `unit_test.yml` |93| Copying mojibake emoji from terminal | Re-read file with UTF-8 or use file content directly |9495## Output Modes9697- **Title only:** Return candidate titles with exact template prefix.98- **Full draft:** Title, template, labels, body in template order, missing info section.99- **Draft conversion:** Normalize user's rough draft to real form; drop sections not in the selected template.100101## Final Check102103- Selected template filename is real in the current checkout.104- Title keeps the selected template prefix exactly, including emoji.105- Title summary describes the actual change/problem and does not contain sequencing markers like `task 1`, `stage 1`, or `phase 1`.106- Labels match the selected template.107- Body fields appear in template order.108- Required fields have content or are listed under `Missing info`.109- Title/body are English-only.110- Checkboxes are not falsely marked complete.111- Path and English audit passes with no local absolute paths, machine-specific roots, or non-English prose.
mxsm