44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
---
|
|
name: groom
|
|
description: >
|
|
Groom and improve issues. Without argument, reviews all open issues. With argument,
|
|
grooms specific issue. Use when grooming backlog, improving issues, or when user
|
|
says /groom.
|
|
model: sonnet
|
|
argument-hint: [issue-number]
|
|
user-invocable: true
|
|
---
|
|
|
|
# Groom Issues
|
|
|
|
@~/.claude/skills/gitea/SKILL.md
|
|
@~/.claude/skills/backlog-grooming/SKILL.md
|
|
@~/.claude/skills/issue-writing/SKILL.md
|
|
|
|
## If issue number provided ($1):
|
|
|
|
1. **Fetch the issue** details with `tea issues <number> --comments`
|
|
2. **Check dependencies** with `tea issues deps list <number>`
|
|
3. **Evaluate** against grooming checklist
|
|
4. **Suggest improvements** for:
|
|
- Title clarity
|
|
- Description completeness
|
|
- Acceptance criteria quality
|
|
- Scope definition
|
|
- Missing or incorrect dependencies
|
|
5. **Ask user** if they want to apply changes
|
|
6. **Update issue** if approved
|
|
7. **Link/unlink dependencies** if needed: `tea issues deps add/remove <issue> <dep>`
|
|
|
|
## If no argument (groom all):
|
|
|
|
1. **List open issues**
|
|
2. **Review each** against grooming checklist (including dependencies)
|
|
3. **Categorize**:
|
|
- Ready: Well-defined, dependencies linked, can start work
|
|
- Blocked: Has unresolved dependencies
|
|
- Needs work: Missing info, unclear, or missing dependency links
|
|
- Stale: No longer relevant
|
|
4. **Present summary** table with dependency status
|
|
5. **Offer to improve** issues that need work (including linking dependencies)
|