issue-triage

iyulab 的头像作者 iyulab

当用户要求"对问题进行分类"、"评估功能请求"、"我应该接受这个问题吗"、"分析GitHub问题"、"审查此拉取请求范围"、"这在此范围内吗"、"我应该如何回应这个问题"、"拒绝此请求"、"接受此贡献"或讨论是否接受、拒绝、调整、推迟或将外部贡献重定向到项目时,应使用此技能。

📖 中文导读:当用户要求"对问题进行分类"、"评估功能请求"、"我应该接受这个问题吗"、"分析GitHub问题"、"审查此拉取请求范围"、"这在此范围内吗"、"我应该如何回应这个问题"、"拒绝此请求"、"接受此贡献"或讨论是否接受、拒绝、调整、推迟或将外部贡献重定向到项目时,应使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: Issue & PR Triage description: This skill should be used when the user asks to "triage an issue", "evaluate a feature request", "should I accept this issue", "analyze GitHub issue", "review this pull request", "review this PR", "should I merge this PR", "is this PR ready", "code review this", "review this contribution", "is this in scope", "how should I respond to this issue", "decline this request", "accept this contribution", "find similar bugs", "detect patterns", "root cause analysis", "fix this bug comprehensively", "give feedback on this PR", "is this secure", "security review", or discusses whether to accept, reject, adapt, defer, merge, or redirect an external contribution (issue or PR) to a project.

Issue & PR Triage Framework

A framework for evaluating external Issues/PRs against project philosophy.

Core Philosophy

"Every issue is an opportunity" - Even declines can improve documentation or reveal API gaps.

"Think 10 from 1" - Extract ten insights from one request.

"Every contribution is a gift" - Honor the contributor's time investment.

"Mentor, not gatekeeper" - Help them succeed.

Issue Decision Matrix

                 | Philosophy HIGH | Philosophy LOW  |
-----------------|-----------------|-----------------|
Feasibility HIGH | ACCEPT          | REDIRECT        |
Feasibility MED  | ADAPT           | DEFER/REDIRECT  |
Feasibility LOW  | DEFER           | DECLINE         |

PR Decision Matrix

                 | Quality HIGH         | Quality LOW          |
-----------------|----------------------|----------------------|
Philosophy HIGH  | APPROVE              | MERGE_WITH_FIXES     |
Philosophy MED   | APPROVE_WITH_NOTES   | REQUEST_CHANGES      |
Philosophy LOW   | REDIRECT             | DECLINE              |

Quick Reference

Issue Verdicts

  • ACCEPT: Implement as requested
  • ADAPT: Implement differently
  • DEFER: Not now, provide roadmap
  • REDIRECT: Out of scope, provide alternatives
  • DECLINE: Philosophy mismatch, explain respectfully

PR Verdicts

  • APPROVE: Ready to merge
  • MERGE_WITH_FIXES: Merge, maintainer fixes
  • REQUEST_CHANGES: Specific fixes needed
  • REDIRECT: Different approach needed
  • DECLINE: Philosophy mismatch

Severity Levels (PR)

| 🔴 Blocker | 🟠 Major | 🟡 Minor | 🟢 Nitpick | ✨ Praise |

Bug Risk Levels

| 🔴 Critical | 🟠 High | 🟡 Medium | 🟢 Low |

Commands

For full workflow:

# Issue triage
/iyu:issue <url | file | "text">
/iyu:issue <input> --quick

# PR review
/iyu:pr <pr-url | #number>
/iyu:pr <input> --quick
/iyu:pr <input> --security-focus

Integration

This framework leverages Claude's capabilities:

  • Code review: Claude performs, iyu provides severity classification framework
  • Security review: Claude detects, iyu applies "security issues are always Blocker" policy
  • Communication: Claude writes, iyu provides response structure per Decision