SKILL.md
Triage
State machine for issues (and external PRs if configured in docs/agents/issue-tracker.md). Every tracker comment starts with:
This was generated by AI during triage.
Run /aiops-setup if triage label mapping is missing.
Roles
Category: bug | enhancement
State: needs-triage | needs-info | ready-for-agent | ready-for-human | wontfix
One category + one state per item. Label strings may differ — use docs/agents/triage-labels.md.
Brief format: [AGENT-BRIEF.md](AGENT-BRIEF.md). Rejections KB: [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md).
Invocation
Natural language: "what needs attention", "triage #42", "move #42 to ready-for-agent".
Show attention
Buckets (oldest first): unlabeled, needs-triage, needs-info with new reporter activity. Tag [PR] vs [issue] when PRs are in scope.
Triage one item
- Gather — body, comments, labels, diff (PR). Check
.out-of-scope/for prior rejections; search codebase for existing implementation. - Recommend category + state; wait for maintainer.
- Verify — reproduce bug or validate PR claims before grilling.
- Grill if needed —
/grilling+/domain-modeling, update CONTEXT/ADRs inline. - Apply outcome:
- ready-for-agent / ready-for-human — post brief - needs-info — triage notes (established + questions for reporter) - wontfix — already implemented (point to code) | rejected bug (close) | rejected enhancement (.out-of-scope/ then close)
Quick override
"Move #N to ready-for-agent" — apply directly after confirm; skip grill unless brief missing.