Skip to content

skill: add triage-issues for labeling open issues - #902

Open
Aditya Shantanu (aditya-shantanu) wants to merge 1 commit into
agent-substrate:mainfrom
aditya-shantanu:skill/triage-issues
Open

skill: add triage-issues for labeling open issues#902
Aditya Shantanu (aditya-shantanu) wants to merge 1 commit into
agent-substrate:mainfrom
aditya-shantanu:skill/triage-issues

Conversation

@aditya-shantanu

Copy link
Copy Markdown
Collaborator

What changed and why

Adds .agents/skills/triage-issues/SKILL.md — a skill agents invoke (via "triage issues") to classify open GitHub issues with the correct kind/, area/, and prio/ labels.

Of 202 open issues, 13 are currently unlabeled. Several labeled issues also lack a kind/ label or use kind/feature for what are really design discussions.

What the skill does

  • Documents the full label taxonomy with clear when-to-apply rules for every existing label
  • Processes unlabeled issues first, then reviews labeled issues for obvious gaps
  • Uses --add-label (not --label) so existing human-applied labels are never overwritten
  • Outputs a report table of every change made, plus flagged uncertainties for maintainer review
  • Never removes labels or adds wontfix/duplicate/invalid — those stay with maintainers

Two new labels proposed

The current taxonomy has two gaps I found while analyzing the backlog:

kind/design — Several issues are design discussions or investigations that must be resolved before any code is written (e.g. "Design discussion: WorkerPool vs. node-level Actor runtime", "Identify what metrics to use for HPA autoscaling", "Measure atenet-router request capacity"). These are currently unlabeled or mislabeled as kind/feature. The skill creates this label if it doesn't exist.

area/benchmarking — The repo has a full benchmarking/ directory but no corresponding area label. Performance measurement issues have nowhere to go. The skill creates this label if it doesn't exist.

Checklist

  • Issue is linked above
  • Tests pass locally (go test ./...)
  • Root-gated tests pass if applicable (hack/run-root-tests.sh)
  • Documentation updated if behavior changed (N/A)

Adds a skill that agents can invoke (via "triage issues") to classify open
GitHub issues with the correct kind/, area/, and prio/ labels.

The skill:
- Documents the full label taxonomy with clear when-to-apply rules
- Adds two missing labels: kind/design (design discussions / investigations
  before implementation) and area/benchmarking (the repo has a benchmarking/
  directory with no corresponding area label)
- Prioritizes unlabeled issues, then reviews labeled issues for gaps
- Uses --add-label so existing human-applied labels are never overwritten
- Includes a classification guide with decision questions and real examples
  drawn from the current issue backlog
- Outputs a report table of what was changed, plus flagged uncertainties

Of 202 open issues, 13 are currently unlabeled. Several labeled issues also
lack a kind/ label or use kind/feature for what are really design discussions.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant