Communitygithub.com

Lev-it/lev-skills

从固定点(提交、分支、标签或合并基线)沿两个维度审查变更:规范(代码是否遵循仓库文档化的编码标准)和规格(代码是否匹配原始需求/PRD的要求)。并行运行两个子代理进行审查,并并排报告结果。当用户想要审查分支、PR、正在进行中的变更,或要求“从X处开始审查”时使用。

lev-skills 是什么?

该AI技能专注于从固定点(如提交、分支、标签或合并基线)与`HEAD`之间的差异进行双轴审查。第一个维度是“规范”,检查代码是否符合仓库文档中的编码标准;第二个维度是“规格”,验证代码是否忠实实现了原始需求或PRD中的要求。这两个维度的审查通过并行子代理独立运行,避免上下文污染,最后汇总报告。该技能支持Git工作流,适用于代码审查场景,尤其是在用户需要确保变更既遵循标准又满足需求时。它能够自动识别规格源(如问题跟踪器引用或文件路径),并提供结构化报告,帮助开发团队高效管理代码质量和一致性。

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

在你喜欢的 AI 中提问

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

文档

对HEAD与用户提供的固定点之间差异的双轴审查:

  • 规范——代码是否符合该仓库文档化的编码标准?
  • 规格——代码是否忠实实现了原始需求/PRD/规格?

两个轴作为并行子代理运行,避免相互污染上下文,然后此技能汇总它们的发现。

问题跟踪器应已提供给你——如果docs/agents/issue-tracker.md缺失,请运行/setup-matt-pocock-skills。

流程

1. 确定固定点

无论用户指定的固定点是什么——提交SHA、分支名、标签、main、HEAD~5等。如果用户未指定,则要求提供。

捕获一次差异命令:git diff <固定点>...HEAD(三点格式,以便与合并基线比较)。同时通过git log <固定点>..HEAD --oneline记录提交列表。

在继续之前,确认固定点能解析(git rev-parse <固定点>)且差异非空。无效引用或空差异应在此处失败——而不是在两个并行子代理内部。

2. 识别规格源

按此顺序查找原始规格:

  1. 提交消息中的问题引用(#123、Closes #45、GitLab !67等)——通过docs/agents/issue-tracker.md中的工作流获取。
  2. 用户作为参数传递的路径。
  3. 位于docs/、specs/或.scratch/下与分支名或特性匹配的PRD/规格文件。
  4. 如果未找到,询问用户规格位置。如果用户表示不存在,则规格子代理将跳过并报告“无可用规格”。

3. 识别规范源

仓库中任何记录代码编写方式的文件,例如CODING_STANDARDS.md或CONTRIBUTING.md。

4. 并行生成两个子代理

发送一条消息,包含两次Agent工具调用。两次都使用general-purpose子代理。

规范子代理提示——包含:

  • 完整的差异命令和提交列表。
  • 你在步骤3中发现的规范源文件列表。
  • 简报:“报告——在相关处按文件/块——差异中每一处违反文档化标准的地方。引用标准(文件+规则)。区分硬性违规和判断性意见。跳过工具强制执行的任何内容。不超过400词。”

规格子代理提示——包含:

  • 差异命令和提交列表。
  • 规格的路径或抓取的内容。
  • 简报:“报告:(a) 规格要求但缺失或不完整的需求;(b) 差异中未经要求的行为(范围蔓延);(c) 看起来已实现但实现有误的需求。对每项发现引用规格原文。不超过400词。”

如果规格缺失,则跳过规格子代理,并在最终报告中注明。

5. 汇总

在## 规范和## 规格标题下逐字或稍作清理地呈现两份报告。不要合并或重新排序发现——两个轴是刻意分开的(参见_为何分为两轴_)。

以一行摘要结束:每个轴的发现总数,以及每个轴内最严重的问题(如果有)。不要跨轴选一个胜者——这就是避免重新排序的分离目的。

为何分为两轴

一次变更可能通过一轴但未通过另一轴:

  • 代码遵循了所有标准但实现了错误的内容 → 规范通过,规格未通过。
  • 代码完全按照需求实现但打破了项目约定 → 规格通过,规范未通过。

分别报告可以防止一轴掩盖另一轴的问题。

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

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

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

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.

相关技能