| name | poll-github-work |
| description | Poll and rank open GitHub issues, RFCs, and pull requests for maintainer work, or start one explicitly selected item. Use when a user asks what to work on, requests backlog priorities, says "poll work," wants actionable issues or pull requests, or says "start |
Poll GitHub Work
Use GitHub as the durable record and
MAINTAINERS.md as the ranking policy. Operate in
recommend mode until the maintainer explicitly selects an item; only then
enter execute mode.
Poll
- Resolve the repository from the user's request or the current checkout.
- Capture the requested component, time window, work types, available test
environments, and candidate limit. State reasonable defaults when omitted.
- Read current open issues, RFCs, pull requests, assignments, milestones,
labels, linked work, reviews, and checks. Prefer a configured GitHub
integration; use
gh when it provides the required repository context.
- Apply the polling ladder in
MAINTAINERS.md: gate, order by impact, classify
readiness, check execution fit, and produce candidate cards.
- Inspect each recommended candidate deeply enough to verify its problem,
evidence, RFC/dependency state, active claims, and likely validation path.
- Return three to five Recommended now cards by default, followed by
Needs triage or blocked and representative exclusions. Include the
repository, exact ISO 8601 polling time with timezone, constraints, and
uncertainty.
For a repository-wide inventory with gh, commands such as these are useful:
gh issue list --repo OWNER/REPO --state open --limit 1000 \
--json number,title,labels,assignees,milestone,createdAt,updatedAt,url
gh pr list --repo OWNER/REPO --state open -- 1000 \
--json number,title,isDraft,labels,author,reviewDecision,statusCheckRollup,createdAt,updatedAt,url
gh issue view NUMBER --repo OWNER/REPO --comments
gh view NUMBER --repo OWNER/REPO \
--json body,files,commits,reviews,reviewDecision,statusCheckRollup,mergeable
