github-issue-prioritizer · diff
git:20260725.fde6af0 to git:20260911.03c3cb8
29 added, 42 removed. Audit A to A.
---
name: github-issue-prioritizer
- description: Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
+ plugin: dev-utils
+ description: >
+ Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
+ USE ONLY when calculating issue priority ranks or generating Projects v2 payload mutations.
+ DO NOT USE for logging issues (use `github-issue-agent`).
+ allowed_tools:
+ - run_command
+ - view_file
+ - write_to_file
+ - replace_file_content
+ - multi_replace_file_content
+ - grep_search
+ - list_dir
---
- # GitHub Issue Prioritizer Skill
+ # GitHub Issue Prioritizer (`github-issue-prioritizer`)
- ## Operational Context & Routing
- Use this skill when you need to calculate issue priority ranks (P0-P3), update priority labels (`priority:P0`..`P3`), or generate payload updates for GitHub Projects v2 custom fields.
+ > **Routing Directive:** USE ONLY when calculating issue priority ranks (P0-P3), updating priority labels (`priority:P0`..`P3`), or generating payload updates for GitHub Projects v2 custom fields. DO NOT USE for friction logging (use `github-issue-agent` instead) or task promotion (use `github-issue-backlog-agent` instead).
- - **Intra-session ephemeral scratchpad**: Use `task-agent`.
- - **Logging friction / bugs**: Use `github-issue-agent`.
- - **Promoting task to issue**: Use `github-issue-backlog-agent`.
- - **Priority ranking & Projects v2 sync**: Use `github-issue-prioritizer`.
+ The `github-issue-prioritizer` skill computes priority ranks from friction tiers, work blockages, and occurrence frequencies to maintain an up-to-date queue of repository tasks.
- ## Priority Ranking Rules
- Priority is determined from three signals:
- 1. **Friction Tier (`tier:0` .. `tier:3`)**: Systemic failures (Tier 3) immediately yield **P0**.
- 2. **Blockage (`blocking`, `type:blocker`)**: Active work blockages increase priority level.
- 3. **Occurrence Frequency**: Repeated friction events escalate priority.
+ ---
- ### Priority Matrix
- - **P0 (Critical / Systemic)**: Tier 3 friction OR (Blocking AND frequency >= 3)
- - **P1 (High Priority)**: Tier 2 friction OR Blocking OR frequency >= 4
- - **P2 (Medium Priority)**: Tier 1 friction OR frequency >= 2
- - **P3 (Low Priority)**: Default / backlog items
+ ## Quick Start & Usage
- ## Core CLI Usage
+ - **Helper Script:** `plugins/dev-utils/skills/github-issue-prioritizer/scripts/gh_issue_prioritize.py`
- ```python
- from plugins.dev_utils.skills.github_issue_prioritizer.scripts.gh_issue_prioritize import (
- prioritize_issue,
- generate_projects_v2_payload
- )
+ ```bash
+ # Prioritize an issue via CLI:
+ python3 plugins/dev-utils/skills/github-issue-prioritizer/scripts/gh_issue_prioritize.py --issue 42
+ ```
- # Calculate issue priority
- issue = {
- "number": 42,
- "title": "Build runner sandbox crash",
- "labels": [{"name": "tier:3"}, {"name": "blocking"}],
- "occurrence_count": 5
- }
- result = prioritize_issue(issue)
- # result["priority"] -> "P0"
- # result["priority_label"] -> "priority:P0"
+ ---
- # Generate GitHub Projects v2 GraphQL mutation payload
- payload = generate_projects_v2_payload(
- project_id="PVT_kwDOA12345",
- item_id="PVTI_lADOA12345",
- field_id="PVTF_priority123",
- single_select_option_id="opt_p0_123"
- )
- ```
+ ## Progressive Disclosure & References
+
+ - **Priority Matrix & API**: [references/priority-matrix.md](references/priority-matrix.md) — complete ranking logic and Python API interface.
+ - **Acceptance Criteria**: [references/acceptance-criteria.md](references/acceptance-criteria.md) — verification contracts and test expectations.
+ - **Fallback Protocol**: [references/fallback-tree.md](references/fallback-tree.md) — missing label defaults and GraphQL fallback procedures.