1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | triage-mattpocock-skills（合集仓库子技能） | 合集仓库子目录名 |
| 所属合集仓库 | mattpocock/skills（Matt Pocock 个人维护，“Skills For Real Engineers”） | GitHub API |
| 作者/维护者 | Matt Pocock（TypeScript 教育者，aihero.dev） | 仓库 README |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/triage | — |
| 许可证 | MIT | GitHub API |
| 该技能自身安装量 | skills.sh 独立统计 69.4 万次（非合集共享星数） | skills.sh |
| 最近提交 | 2026-08-19（该子目录路径过滤后的最后一次改动） | GitHub API |
| 安装方式 | Claude Code 插件市场一条命令，或通用安装器 npx skills add（见第十章） |
官方 README |
2. 功能介绍与亮点
triage 把项目 Issue Tracker 上的 Issue 与 PR 纳入一套固定的状态机管理：两个分类角色（bug/enhancement）与五个状态角色（needs-triage/needs-info/ready-for-agent/ready-for-human/wontfix），每条 Issue 始终只带一个分类 + 一个状态标签。
- PR 视为“带代码的 Issue”：同一套角色与状态机同时覆盖外部 PR，可直接检出分支跑测试验证 diff 是否真的解决了问题
- 落地前先验证：对 bug 类要求先按报告步骤复现，对 PR 要求跑通相关测试，“已确认”与“复现失败/信息不足”分别导向不同下一步，而不是凭描述直接分类
- 代码库先查重复实现再分诊：分诊前按领域概念（而非字面措辞）搜索代码库是否已有等价实现，命中即判“已实现”关闭而非当新需求处理
ready-for-agent产出结构化交接简报，ready-for-human说明为何不能转交 agent（需人工判断、外部访问权限、设计决策等）- 拒绝的需求写入
.out-of-scope/知识库，避免同一被拒需求反复被重新提出时重新讨论 - 必须挂免责声明：AI 生成的每条分诊评论都强制带“该内容由 AI 生成”提示，对协作者透明
3. 适用场景
所属分类：工程效率与代码质量。 该技能面向已有的 Issue/PR 队列产出问题分类与执行建议，不新建交付物，与同类的代码审查、缺陷排查工具（如 sentry-debug-issue、github-triage-trailofbits-skills）属同一分类。
适用于维护活跃开源仓库、Issue/PR 积压较多的团队或个人维护者：把“看一眼这堆 Issue”变成有固定标准的分诊流程，尤其适合把 AFK agent 纳入研发流程的团队——ready-for-agent 简报可直接作为下一步执行的输入，减少人工二次转述需求的成本。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——仓库自带
.claude-plugin/plugin.json，/plugin install mattpocock-skills一键安装 - Codex：✅ 支持——README 明确将 Codex 列为“Codex, and other agents”安装分支目标，经通用安装器
npx skills add mattpocock/skills安装，该安装器官方 Supported Agents 列表列出 Codex 项目路径 - OpenClaw：✅ 支持——同一份通用安装器 Supported Agents 列表列出 OpenClaw 路径（
~/.openclaw/skills/） - Hermes Agent：✅ 支持——同一份列表同时列出 Hermes Agent 路径（
~/.hermes/skills/）
5. 推荐理由
把“处理 Issue 堆积”从随手贴标签，变成一套有验证步骤、有交接标准的固定流程：分诊前先查重复实现与历史拒绝记录，分诊后产出的简报可直接喂给下一个执行 agent，减少“我以为你说的是……“式的返工。四个目标生态均可安装，16 条独立 GitHub issue、15 个不同用户的真实反馈证明这是被高频使用而非发布即弃的技能。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 该技能自身在 skills.sh 独立统计安装 69.4 万次（合集仓库 stars 不计入个体热度）；GitHub issue 区有 16 条独立议题、15 个不同用户专门就该技能提出问题或建议，构成多来源活跃讨论 |
| 可用性 | 8 | SKILL.md 含完整的角色/状态机说明与配套模板（AGENT-BRIEF.md、OUT-OF-SCOPE.md），近期（2026-08-19）仍有改动；需先运行配套的 setup-matt-pocock-skills 完成标签映射才能完整工作，且有若干未关闭的边界场景反馈（如标签缺失、重复验收标准） |
| 安全性 | 8 | 纯提示词类技能，读取 Issue Tracker 数据并生成评论/标签建议，不执行任意代码、不外发凭据；第三方安全审计 Gen Agent Trust Hub 与 Socket 均 Pass，Snyk 为 Warn（非 Pass，因此未给满分）；License 明确、无可疑指令 |
综合评分：8.0
7. 跟同类 Skills 相比的优势
| 对比项 | triage（本技能） | github-triage（Trail of Bits） |
|---|---|---|
| 工作模式 | 持久化标签状态机，长期跟踪每条 Issue/PR 的分诊阶段 | 一次性批量梳理，每次运行对全部未关闭项做优先级/工作量估算 |
| PR 支持 | 与 Issue 共用同一套角色和状态机，可直接检出跑测试验证 | 侧重合并可合并 PR、为未审 PR 生成只读评审报告 |
| 产出形式 | ready-for-agent/ready-for-human 结构化交接简报 |
Critical/High/Medium/Low 优先级 + size 估算，明确不回写标签 |
| 依赖工具 | 通用（Issue Tracker 抽象，支持 GitHub/Linear/本地文件） | 强绑定 gh CLI，仅面向 GitHub |
github-triage 更适合定期做一次性仓库清理，triage 更适合把分诊结果长期沉淀进标签体系、持续对接 agent 执行链路。
8. 用户评价
已通过 GitHub issue 区核实到多条独立用户反馈（均为功能建议或缺陷报告，而非泛泛好评）：
- hades200082（issue #329，2026-06-11）：建议增加自动串联 triage 与 tdd 两个技能的机制，反映该用户把两个技能组合进日常研发流程使用
- malcolmpl（issue #289，2026-05-29）：指出“暂缓但非彻底拒绝”的边界情形（dormant defect）目前没有归属状态，属于对状态机颗粒度的具体改进诉求
- erikpr1994（issue #860，2026-08-14）：提出
ready-for-agent应额外标注执行者角色而非只标技能名，属于对交接简报字段设计的具体反馈
9. 安装使用方式
- Claude Code：
claude plugins install mattpocock-skills或会话内/plugin install mattpocock-skills，随官方插件市场自动更新 - Codex / 其他 agent（含 OpenClaw、Hermes Agent）：
npx skills@latest add mattpocock/skills，安装时勾选triage，同时建议勾选setup-matt-pocock-skills（用于映射本仓库的自定义标签体系） - 安装后需先在目标仓库运行一次
/setup-matt-pocock-skills，选择 Issue Tracker 类型（GitHub / Linear / 本地文件）并录入标签映射，之后即可用/triage触发
10. 注意事项
- 未运行
setup-matt-pocock-skills前，triage无法识别自定义标签映射，会提示先完成配置 - 部分边界场景（如“暂缓但未被拒绝”的缺陷归档、批量回填历史 Issue 时跳过评论细节）仍有开放中的社区反馈，尚未修复
- 技能生成的每条评论固定携带“AI 生成”免责声明，团队协作场景下这一透明度设计本身也是可审计点