Skip to content

chore(agents): add github-triage skill for Conventional Commit label triage (#151) - #225

Open
wufangyong973 wants to merge 1 commit into
PAIR-code:mainfrom
wufangyong973:gfi/151-github-triage-skill
Open

wufangyong973 wants to merge 1 commit into
PAIR-code:mainfrom
wufangyong973:gfi/151-github-triage-skill

Conversation

@wufangyong973

Copy link
Copy Markdown

Closes #151

Scaffold the .agents/skills/github-triage/ skill so an assistant can audit and backfill type: / scope: labels without re-discovering the taxonomy on every pass.

What changed

  • SKILL.md — operational runbook: the full type:* / scope:* matrix (sourced from .github/labels.yml), resolution rules for unrecognized scopes and -private packages, and the four-step Scan → Audit → Review → Apply workflow. Follows the front-matter + H1 + Companion Scripts + Operational Invariants structure of the sibling github-issues / github-pr skills, and the agent-skills canons (runtime-execution runbook, no metadata duplication).
  • scripts/triage-audit.sh — pure POSIX shell diagnostic. Resolves the triangular upstream remote, parses Conventional Commit titles, cross-references the vocabulary in .github/labels.yml, and emits an unadorned TSV (NUMBER\tTYPE\tSCOPE\tSTATUS\tMISSING_LABELS\tUNRECOGNIZED_SCOPES). Supports --unlabeled, --since N, --prs, --json, and --repo. Shunts output above 8 KB to /tmp/. Set executable (chmod +x).
  • AGENTS.md — new ## 3. Agent Skills section registering the skill.
  • llms.txt — a single directory-level entry under Agent & Contributor Orientation, delegating depth to SKILL.md per the llms-txt-must-index-surfaces-not-individual-files and llms-txt-must-delegate-depth canons.

Verification

Ran the script offline against a simulated gh fixture (no network, no live state):

  • TSV columns align; type: feat on feat(lsp) and type: refactor + scope: core on refactor(core) are reported as missing when the labels are absent;
  • unrecognized scopes lsp and repo-lint are surfaced in the UNRECOGNIZED_SCOPES column without inventing labels;
  • --unlabeled filters to rows with at least one gap; --since N starts the backfill pass at N; --prs merges PR rows;
  • an oversized input triggers the 8 KB /tmp/ shunt with the [OUTPUT TRUNCATED] banner.
    The script's exit code is propagated through the shunt wrapper, and $EXIT_CODE is preserved across the set -e boundary.

No change to CLI semantics, canon lints, or Rust build; pure agent-skill addition.

@google-cla

google-cla Bot commented Oct 15, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@wufangyong973
wufangyong973 force-pushed the gfi/151-github-triage-skill branch from 6a002be to 033fff7 Compare October 22, 2026 22:09
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.

chore(agents): create github-triage skill for Conventional Commit label triage and auditing

1 participant