ticket-improvement

Ticket Improvement

Scope-Disambiguation: Dieses Skill beschreibt L0-Orchestrierung: wie Phase 0.5 Tickets auswählt, scored, Subagent dispatched und Diff-Approval einholt. Die konkrete Improvement-Logik (Single-Ticket-Score → Improvement-Body) liegt im Subagent mmp:ticket-improver (agents/ticket-improver.md). Für den Skill ist der Subagent eine Black-Box, die nach Dispatch einen YAML-Improvement-Block zurückgibt.

Workflow

1. Fetch tickets in scope (orchestrator or standalone command provides list).
2. Score each ticket: GOOD | NEEDS_IMPROVEMENT | POOR. Skip GOOD. See references/quality-rubric.md.
3. For NEEDS/POOR: spawn mmp:ticket-improver subagent with self-contained prompt:
   • Original body (verbatim)
   • Repo conventions excerpt
   • Linked-issue context (gh issue view <linked> --json body,title)
   • HARD RULES (verbatim — see below)
4. Subagent returns structured Markdown. Save draft + original to .orchestrator/improved-tickets/<id>.{draft,original}.md.
5. Per-ticket diff preview (Original ↔ Improved). User approves accept | reject | edit-then-accept | skip.
6. On accept + mode=live:
   • Race-detect: re-fetch via gh, hash-compare.
   • Post backup comment with original body, capture comment id.
   • gh issue edit <id> --body-file <improved>.
   • Record in status.yaml ticket_improvements[].
7. On accept + mode=local: write final to <id>.md. Orchestrator uses local versions for downstream phases.
8. Collect Open Questions from improvers across all tickets, batch to user before returning to caller.

HARD RULES (passed verbatim into improver prompt)

1. NEVER change scope. Only clarify what's already implied.
2. NEVER invent acceptance criteria the original didn't imply.
3. If something genuinely missing → ## Open Question block, do NOT guess.
4. Preserve all original references, links, screenshots.
5. Keep the original author's voice where possible.

Improver output template

## Context
<why this matters, derived from existing body + linked issues>

## Acceptance Criteria
- [ ] <testable condition 1>
- [ ] <testable condition 2>

## Out of Scope
<explicit non-goals if any>

## Notes / Links
<preserve original references>

## Open Questions   (only if needed)
- <question 1>
- <question 2>

Live-mode safety guardrails (non-negotiable)

• Per-ticket diff preview (no batched approval).
• Original-body backup as gh comment + local file.
• Race-detect via hash compare before edit.
• Skip-labels honored (config.ticket_improvement.skip_labels).
• Disallowed combination: mode=live + diff_preview=none → hard error.

When to skip a ticket

• Has a label in config.ticket_improvement.skip_labels.
• Score is GOOD.
• Already has ticket_improvements[] entry with applied_at != null AND current original_hash matches improved_hash (idempotency).