Agent skill

Triage

by devcxl in devcxl/mattpocock-skills-zh

将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问,并写出 agent 就绪的任务简报. An agent skill from devcxl/mattpocock-skills-zh.

MITAuto-check passedDevelopment

Install Triage

skills CLI
$ npx skills add devcxl/mattpocock-skills-zh --skill triage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install devcxl/mattpocock-skills-zh triage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/engineering/triage .claude/skills/triage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
triage
GitHub stars
433
Used in
1 other repo
Token cost
~816 tokens
SKILL.md length
194 words
Files
4
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问,并写出 agent 就绪的任务简报. An agent skill from devcxl/mattpocock-skills-zh.

  • Works in 3 steps: 未打标签——从未被分类过。 → needs-triage——正在评估中。 → needs-info 且报告人在上次分类笔记之后有活动——需要重新评估。
  • Development work in your project
  • SKILL.md covers 参考文档, 角色, 调用 and 展示需要关注的内容, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Triage is an agent skill from devcxl/mattpocock-skills-zh. 将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问,并写出 agent 就绪的任务简报。

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `AGENT-BRIEF.md`, `OUT-OF-SCOPE.md` and `agents/openai.yaml`).

It sits in Development. The repository describes itself as: Matt Pocock 技能集的中文翻译版 — 地道中文,原汁原味的技术术语。基于 mattpocock/skills 复刻。每日中午12点钟同步. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/triage”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 未打标签——从未被分类过。
  2. needs-triage——正在评估中。
  3. needs-info 且报告人在上次分类笔记之后有活动——需要重新评估。

What it can do on your machine

Read from SKILL.md and the folder at commit b72cc5b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Triage loads about 816 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 194 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~816

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from devcxl/mattpocock-skills-zh at commit b72cc5b, republished under its MIT licence (© devcxl). 194 words, ~816 tokens.

Download SKILL.mdSave it as .claude/skills/triage/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
triage
description
将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问,并写出 agent 就绪的任务简报。
disable-model-invocation
true

分类(Triage)

让项目问题跟踪器上的 issue 走一遍由分类角色组成的小型状态机。

如果本仓库把外部拉取请求(PR)也当作请求入口(见 issue-tracker 配置),分类也覆盖它们:PR 就是带着代码的 issue——同样的角色、同样的状态、同样的状态机,只有少数几处下面标注了"仅限 PR"的差异。根据跟踪器配置,把裸的 #42 解析为 issue 或 PR。

分类期间发布到问题跟踪器的每条评论或 issue 必须以这段免责声明开头:

> *This was generated by AI during triage.*

参考文档

角色

两个类别角色:

  • bug — 有东西坏了
  • enhancement — 新功能或改进

五个状态角色:

  • needs-triage — 等待维护者评估
  • needs-info — 等待报告人补充信息
  • ready-for-agent — 已完全明确,可供 AFK agent 接手
  • ready-for-human — 需要人工实现
  • wontfix — 不会处理

对 PR 而言,同样的状态对应到所附代码上:ready-for-agent 意味着已附上 brief,agent 应该对 diff 采取下一步;ready-for-human 意味着已准备好由人来合并。

每个经过分类的 issue 都应恰好带一个类别角色和一个状态角色。如果状态角色冲突,先标记出来并询问维护者,再做任何其他事情。

这些是规范角色名——问题跟踪器中实际使用的标签字符串可能不同。映射关系应该已经提供给你了——如果没有,告诉用户运行 /setup-matt-pocock-skills。

状态转换:未打标签的 issue 通常先进入 needs-triage;从那里转到 needs-info、ready-for-agent、ready-for-human 或 wontfix。报告人回复后,needs-info 回到 needs-triage。维护者随时可以推翻——遇到看起来不寻常的转换要标记出来,先问再行动。

调用

维护者调用 /triage 并用自然语言描述想要什么。理解请求并行动。例如:

  • "把需要我关注的东西都给我看看"
  • "看看 #42"(issue 或 PR)
  • "把 #42 移到 ready-for-agent"
  • "有哪些是 agent 可以接手的?"

展示需要关注的内容

查询问题跟踪器,按从旧到新展示三个桶:

  1. 未打标签——从未被分类过。
  2. needs-triage——正在评估中。
  3. needs-info 且报告人在上次分类笔记之后有活动——需要重新评估。

当 PR 在范围内时,把外部 PR 也放进这些桶,并在每一行标注 [PR] 或 [issue]。发现面只呈现外部 PR(跟踪器配置定义谁算外部)——协作者进行中的 PR 不是分类工作。这个过滤只作用于发现面;被明确点名的 PR 无论作者是谁都要分类。

展示每个条目的数量和一行摘要。让维护者挑选。

分类某个具体的 issue 或 PR

  1. 收集上下文。 读完整的 issue 或 PR(正文、评论、标签、作者、日期;PR 还要读 diff)。解析之前的分类笔记,不要重复问已解决的问题。使用项目的领域词汇表探索代码库,尊重相关区域的 ADR。对代码库做两项检查:(a) 冗余——按领域概念(而不只是请求的措辞)搜索请求的行为是否已有实现,并报告你查过哪里。如果找到了,就是已实现的 wontfix(步骤 5)。(b) 先前拒绝——读 .out-of-scope/*.md,找出任何与本请求相似的条目。

  2. 给出建议。 告诉维护者你的类别和状态建议及理由,外加与请求相关的简要代码库摘要——包括是否已实现。等待指示。

  3. 验证主张。 在任何盘问之前,先确认主张站得住脚。对 bug,按报告人的步骤复现。对 PR,确认 diff 确实做了它声称的事——checkout 下来,运行相关测试或命令。报告发生了什么:已确认(附代码路径)、失败、或细节不足(强烈的 needs-info 信号)。确认过的验证能产生强得多的 agent brief。

  4. 盘问(如需)。 如果请求需要补充打磨,调用 Skill 工具两次,分别传入 "grilling" 和 "domain-modeling"——一轮一轮地把它盘问成型,随着决策落定,同步打磨领域术语并更新 GLOSSARY.md/ADR。

  5. 应用结果:

    • ready-for-agent — 发布 agent brief 评论(AGENT-BRIEF.md)。
    • ready-for-human — 结构同 agent brief,但要注明为什么不能委派(需要判断、外部访问、设计决策、人工测试)。
    • needs-info — 发布分类笔记(模板见下)。
    • wontfix — 关闭,评论内容取决于原因:
      • 已实现 — 代码库中已存在该改动。指出它在哪里;不要写入 .out-of-scope/(那个知识库是给被拒绝的请求的,不是给已实现的)。
      • 被拒绝(bug) — 礼貌解释,然后关闭。
      • 被拒绝(enhancement) — 写入 .out-of-scope/,在评论里链接到它,然后关闭(OUT-OF-SCOPE.md)。
    • needs-triage — 应用该角色。如果有部分进展,可选加一条评论。

快速状态覆盖

如果维护者说"把 #42 移到 ready-for-agent",相信他们,直接应用该角色。确认你将要做的(角色变更、评论、关闭),然后行动。跳过盘问。如果在没有盘问会话的情况下移到 ready-for-agent,问他们是否想写 agent brief。

Needs-info 模板

markdown
## Triage Notes

**What we've established so far:**

- point 1
- point 2

**What we still need from you (@reporter):**

- question 1
- question 2

把盘问期间解决的所有内容记入"established so far"之下,以免工作丢失。问题必须具体且可执行,而不是"请提供更多信息"。

恢复之前的会话

如果 issue 或 PR 上已有先前的分类笔记,读它们,检查报告人是否回答了未解决的问题,并在继续之前呈现更新后的图景。不要重复问已解决的问题。

© devcxl, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/engineering/triage of devcxl/mattpocock-skills-zh.

  • SKILL.md
  • AGENT-BRIEF.md
  • OUT-OF-SCOPE.md
  • agents/openai.yaml

Open the folder on GitHubat commit b72cc5b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in devcxl/mattpocock-skills-zh, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Triage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Triage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Triage this skilldevcxl/mattpocock-skills-zh4331 repos~816Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k24 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 24 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed

More from devcxl/mattpocock-skills-zh

All 20 skills in this repo
  • Git Guardrails Claude Code

    devcxl/mattpocock-skills-zh

    设置 Claude Code 钩子,在危险 Git 命令(push、reset --hard、clean、branch -D 等)执行前将其拦截。当用户想要防止破坏性 Git 操作、添加 Git 安全钩子或在 Claude Code 中阻止 git push/reset 时使用。

    433 GitHub stars~420 tokensUpdated yesterday
    Auto-check passed
  • Codebase Design

    devcxl/mattpocock-skills-zh

    设计深度模块的共享词汇。当用户想要设计或改进模块的接口、寻找深化机会、决定 seam 的位置、让代码更可测试或更易被 AI 导航,或者其他 skill 需要深度模块词汇时使用。

    433 GitHub stars~809 tokensUpdated yesterday
    Auto-check passed
  • Diagnosing Bugs

    devcxl/mattpocock-skills-zh

    针对棘手 bug 和性能回归的诊断循环。当用户说"诊断"/"调试这个",或报告某处崩溃/报错/不正常/缓慢时使用. An agent skill from devcxl/mattpocock-skills-zh.

    433 GitHub stars~958 tokensUpdated yesterday
    Auto-check passed
  • Domain Modeling

    devcxl/mattpocock-skills-zh

    构建和完善项目的领域模型。当讨论代码库术语、编写或编辑 GLOSSARY.md,或记录或编辑 ADR 时使用. An agent skill from devcxl/mattpocock-skills-zh.

    433 GitHub stars~412 tokensUpdated yesterday
    Auto-check passed
  • Migrate To Shoehorn

    devcxl/mattpocock-skills-zh

    将测试文件从 as 类型断言迁移到 @total-typescript/shoehorn。当用户提到 shoehorn、想要在测试中替换 as、或需要部分测试数据时使用。

    433 GitHub stars~522 tokensUpdated yesterday
    Auto-check passed
  • Scaffold Exercises

    devcxl/mattpocock-skills-zh

    创建包含 section、problem、solution 和 explainer 的练习目录结构,且能通过 lint 检查。当用户想要搭建练习框架、创建练习模板或设置新的课程章节时使用。

    433 GitHub stars~659 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Triage

What does Triage do?

将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问,并写出 agent 就绪的任务简报. An agent skill from devcxl/mattpocock-skills-zh. Triage is an agent skill from devcxl/mattpocock-skills-zh.

When should I use Triage?

Triage fits situations like: development work in your project.

How do I install Triage in Claude Code?

Run `npx skills add devcxl/mattpocock-skills-zh --skill triage -a claude-code`. Or copy the skill folder (skills/engineering/triage in devcxl/mattpocock-skills-zh) into .claude/skills/triage in your project. Claude Code loads it when a task matches its description.

How do I install Triage in Codex?

Run `npx skills add devcxl/mattpocock-skills-zh --skill triage -a codex`. Or copy the skill folder (skills/engineering/triage in devcxl/mattpocock-skills-zh) into .agents/skills/triage in your project. Codex loads it when a task matches its description.

Can I use Triage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add devcxl/mattpocock-skills-zh --skill triage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/triage, .gemini/skills/triage, .github/skills/triage and .opencode/skills/triage in your project.

What does Triage need to run?

SKILL.md names no scripts, command-line tools or credentials: Triage is instructions for the agent only.

Does Triage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Triage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Triage use?

Triage is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Triage use?

About 816 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Triage?

Skills that share tags, products or a category with Triage: Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Triage?

devcxl (a GitHub user) maintains it in devcxl/mattpocock-skills-zh, which has 433 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 5, 2026.

Source: devcxl/mattpocock-skills-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.