Communitygithub.com

Lev-it/lev-skills

通过分类、复现、追问等状态机流程,将议题转化为可供智能体直接执行的简报

lev-skills 是什么?

本技能为议题跟踪系统实现了一套基于状态机的分类处理流程。它定义了 `bug` 和 `enhancement` 两个分类角色,以及 `needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human` 和 `wontfix` 五个状态角色,每个经过处理的议题必须携带一个分类角色和一个状态角色。技能支持查看待处理议题、对特定议题执行全流程分类(包括上下文收集、复现、追问、域名建模),并能快速跳转到指定状态。当议题进入 `ready-for-agent` 状态时,会自动生成结构化的智能体简报;对于不在范围内的需求,则写入 `.out-of-scope/` 知识库。该技能适用于支持自然语言指令的智能体平台,维持者只需通过 `/triage` 命令描述需求即可驱动整个流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/triage

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

分类处理

通过一个由分类角色组成的简单状态机,在项目的议题跟踪器中移动议题。

在分类处理期间,发布到议题跟踪器的每条评论或议题必须以以下免责声明开头:

> *此内容由AI在分类处理期间生成。*

参考文档

角色

两个分类角色:

  • bug — 某功能已损坏
  • enhancement — 新功能或改进

五个状态角色:

  • needs-triage — 需要维护者评估
  • needs-info — 等待报告人提供更多信息
  • ready-for-agent — 已完全指定,可供离线智能体处理
  • ready-for-human — 需要人工实现
  • wontfix — 不处理

每个经过分类的议题应恰好携带一个分类角色和一个状态角色。如果状态角色冲突,请标记冲突并向维护者请示,然后再进行其他操作。

这些是规范的角色名称——议题跟踪器中实际使用的标签字符串可能有所不同。映射关系应已提供给您——如果尚未提供,请运行 /setup-matt-pocock-skills。

状态转换:未标记的议题通常首先进入needs-triage;从那里移动到needs-info、ready-for-agent、ready-for-human或wontfix。一旦报告人回复,needs-info会返回needs-triage。维护者可以随时覆盖——请标记看起来异常的转换,并在继续操作前请示。

调用方式

维护者调用/triage并用自然语言描述他们的需求。解释请求并执行。示例:

  • “显示所有需要我关注的内容”
  • “我们来看看 #42”
  • “将 #42 移至 ready-for-agent”
  • “哪些议题已经准备好供智能体处理?”

显示需要关注的内容

查询议题跟踪器并按以下三个分组呈现,旧的在前:

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

显示每个分组的计数以及每个议题的单行摘要。让维护者选择。

分类特定议题

  1. 收集上下文。 阅读完整的议题(正文、评论、标签、报告人、日期)。解析任何先前的分类记录,避免重复提问已解决的问题。使用项目的领域术语表探索代码库,尊重相关区域的架构决策记录(ADR)。阅读 .out-of-scope/*.md,找出任何与当前议题类似的先前被拒绝的议题并予以呈现。

  2. 推荐。 向维护者告知您的分类和状态推荐并附上理由,同时提供与该议题相关的简要代码库摘要。等待指示。

  3. 复现(仅限 bug)。 在任何追问之前,尝试复现:阅读报告人的步骤,跟踪相关代码,运行测试或命令。报告发生了什么——成功复现并附带代码路径、复现失败,或信息不足(这是一个强烈的needs-info信号)。确认的复现能使智能体简报更加强大。

  4. 追问(如果需要)。 如果议题需要补充细节,请同时运行 /grilling 和 /domain-modeling 技能——一次一个问题地询问议题细节,逐步明确领域术语,并在决策确定时内联更新 CONTEXT.md/ADR。

  5. 应用结果:

    • ready-for-agent — 发布智能体简报评论(AGENT-BRIEF.md)。
    • ready-for-human — 结构与智能体简报相同,但需说明为何不能委托(判断性决策、外部访问、设计决策、手动测试)。
    • needs-info — 发布分类记录(模板见下文)。
    • wontfix(bug) — 礼貌解释,然后关闭。
    • wontfix(enhancement) — 写入 .out-of-scope/,在评论中链接到它,然后关闭(OUT-OF-SCOPE.md)。
    • needs-triage — 应用角色。可选地添加评论以记录部分进展。

快速状态覆盖

如果维护者说“将 #42 移至 ready-for-agent”,请信任他们并直接应用角色。确认您将要执行的操作(角色更改、评论、关闭),然后执行。跳过追问步骤。如果移动到 ready-for-agent 但未经过追问环节,请询问他们是否要编写智能体简报。

需要信息模板

## 分类记录

**目前我们已经确定的内容:**

- 要点 1
- 要点 2

**我们仍需要的来自您(@报告人)的信息:**

- 问题 1
- 问题 2

在“已确定的内容”下捕捉追问期间解决的所有内容,以确保工作不会丢失。问题必须具体且可操作,而非“请提供更多信息”。

恢复之前的会话

如果议题上存在先前的分类记录,请阅读它们,检查报告人是否已回答了任何未解决的问题,并在继续之前呈现更新的状态。不要重复提问已解决的问题。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

相关技能