Language: Always interact with the user in 日本語.
bug-report-en
Usable by non-engineers. Just answer questions to create a proper bug report.
Prerequisites
- Claude Code environment
gh CLI (for GitHub Issue output)
Arguments
- Text (e.g.,
/bug-report-en Can't log in): Use as initial info, interview for missing details
- No arguments: Start interviewing from scratch
Phase 1: Interview
Ask in plain language without technical jargon.
1-1: Basic Information
Use AskUserQuestion to gather (skip what's already known from arguments):
- What happened: What problem occurred
- Where it happened: Which screen, feature, or page
- Error messages: Displayed on screen or console (request screenshots)
1-2: Follow-up Questions
Ask only what's needed based on responses (max 3, don't ask what can be inferred):
| Situation |
What to ask |
| Error message exists |
Error details, screenshots |
| Reproduction unclear |
Every time or specific conditions |
| Screen/UI issue |
Browser, device, screen size |
| Data issue |
Specific data/account only |
| Timing issue |
Since when, recent changes |
| Steps unclear |
Specific operation steps |
Phase 2: Codebase Investigation
- Identify related code — Search by screen/feature name/error message with
Grep/Glob. Use Explore agent for broader investigation if needed
- Estimate cause — Trace from error messages/stack traces. State confidence level (certain / likely / needs investigation)
- Check impact scope — Check other features using same code, related tests
- Attempt reproduction — Only if reproducible via tests or commands. Do not create tests
Phase 3: Duplicate Check
- Search existing Issues with
gh issue list --state open --search "<bug-summary>"
- If similar Issue found -> report to user, confirm whether to comment on existing or create new
Phase 4: Preview and Output Destination
- Create draft from gathered info and investigation results
- Show preview to user (technical content + plain explanation)
- Apply revisions if any
- Confirm output destination with
AskUserQuestion:
- GitHub Issue (recommended)
- Local MD file
Phase 5: Output
GitHub Issue
- Create with
gh issue create, title bug: <summary>, label bug
- Use template from
templates/issue.md
- Report URL to user
Local MD
- Generate
bug-report-<summary-kebab-case>.md
- Report path to user
Severity Criteria
| Severity |
Criteria |
Example |
| Critical |
Service down, data loss, security risk |
Can't log in, data deleted |
| High |
Major feature unusable, no workaround |
Search broken, can't save |
| Medium |
Feature works but inconvenient, workaround exists |
Display broken, slow |
| Low |
Minor, no usage impact |
Typo, color mismatch |
Rules
- No technical jargon in interviews. Mirror user's own terms only
- Minimal questions. Don't ask what can be inferred
- Code investigation must verify against actual code, not guess
- State confidence level honestly for cause estimates
- Always preview and get user approval before creating Issue
- Do not modify code. Output is Issue only
- If fix is needed, suggest
/bug-fix #<issue-number>
1---2name: bug-report-en3description: Interactively gather bug details, investigate code, and create a structured GitHub Issue.4---56**Language: Always interact with the user in 日本語.**78# bug-report-en910Usable by non-engineers. Just answer questions to create a proper bug report.1112## Prerequisites1314- Claude Code environment15- `gh` CLI (for GitHub Issue output)1617## Arguments1819- **Text** (e.g., `/bug-report-en Can't log in`): Use as initial info, interview for missing details20- **No arguments**: Start interviewing from scratch2122## Phase 1: Interview2324**Ask in plain language without technical jargon.**2526#### 1-1: Basic Information2728Use `AskUserQuestion` to gather (skip what's already known from arguments):291. **What happened**: What problem occurred302. **Where it happened**: Which screen, feature, or page313. **Error messages**: Displayed on screen or console (request screenshots)3233#### 1-2: Follow-up Questions3435Ask **only what's needed** based on responses (max 3, don't ask what can be inferred):3637| Situation | What to ask |38|-----------|-------------|39| Error message exists | Error details, screenshots |40| Reproduction unclear | Every time or specific conditions |41| Screen/UI issue | Browser, device, screen size |42| Data issue | Specific data/account only |43| Timing issue | Since when, recent changes |44| Steps unclear | Specific operation steps |4546## Phase 2: Codebase Investigation47481. **Identify related code** — Search by screen/feature name/error message with `Grep`/`Glob`. Use `Explore` agent for broader investigation if needed492. **Estimate cause** — Trace from error messages/stack traces. State confidence level (certain / likely / needs investigation)503. **Check impact scope** — Check other features using same code, related tests514. **Attempt reproduction** — Only if reproducible via tests or commands. Do not create tests5253## Phase 3: Duplicate Check54551. Search existing Issues with `gh issue list --state open --search "<bug-summary>"`562. If similar Issue found -> report to user, confirm whether to comment on existing or create new5758## Phase 4: Preview and Output Destination59601. Create draft from gathered info and investigation results612. Show preview to user (technical content + plain explanation)623. Apply revisions if any634. Confirm output destination with `AskUserQuestion`:64 - **GitHub Issue** (recommended)65 - **Local MD file**6667## Phase 5: Output6869#### GitHub Issue70- Create with `gh issue create`, title `bug: <summary>`, label `bug`71- Use template from `templates/issue.md`72- Report URL to user7374#### Local MD75- Generate `bug-report-<summary-kebab-case>.md`76- Report path to user7778## Severity Criteria7980| Severity | Criteria | Example |81|----------|----------|---------|82| Critical | Service down, data loss, security risk | Can't log in, data deleted |83| High | Major feature unusable, no workaround | Search broken, can't save |84| Medium | Feature works but inconvenient, workaround exists | Display broken, slow |85| Low | Minor, no usage impact | Typo, color mismatch |8687## Rules8889- **No technical jargon** in interviews. Mirror user's own terms only90- **Minimal questions**. Don't ask what can be inferred91- Code investigation must **verify against actual code**, not guess92- State confidence level honestly for cause estimates93- **Always preview and get user approval** before creating Issue94- Do not modify code. Output is Issue only95- If fix is needed, suggest `/bug-fix #<issue-number>`
ousiass