name: issue
description: Clarify and organize GitHub issue requirements, or create new issues
argument-hint:
disable-model-invocation: true
issue
Task
Clarify and organize GitHub issue requirements.
Arguments
- Number: Fetch and update existing issue
- Non-number: Create new issue using argument as title
Workflow
Update existing issue (argument is number)
- Fetch issue with
gh issue view {number} - Research codebase to understand current behavior and constraints
- Organize requirements
- Functional requirements
- Items requiring decision (present options)
- Potential issues / Edge cases
- Confirm decisions with user
- Draft updated issue body and present to user
- After approval, update with
gh issue edit
Create new issue (argument is non-number)
- Use argument as title, ask user for necessary information
- Research codebase to understand current behavior and constraints
- Organize requirements (same as above)
- Confirm decisions with user
- Draft issue body and present to user
- After approval, create with
gh issue create
Output Format
Issue body should include:
- Summary
- Requirements (functional requirements, specifications)
- Acceptance criteria
- Non-functional requirements (if applicable)
- Out of scope (if clarification needed)
Examples
/issue 149- Fetch and update Issue #149/issue User profile edit feature- Create new issue