mcpField
D
deep-review

deep-review

github.com/anorth测试与质量110 次安装今天更新
代码仓库

关于 deep-review

deep-review 为 `/review-diff` 技能增加更多代码审查视角,面向需要按相关主题检查变更集的审查工作。它依赖 `review-diff`;若该技能不可用则停止。

主要功能

  1. 01加入强级别的标准审查视角
  2. 02应用始终相关的低成本主题
  3. 03根据变更选择条件主题
  4. 04沿用 review-diff 流程进行检查与报告

适用场景

  1. 01按多个主题审查变更集
  2. 02检查差异中的命名、风格与注释
  3. 03针对匹配的变更类型增加定向检查

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/anorth/agent-skills --skill deep-review

安装后在 Claude Code 中输入/deep-review确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

themes/
change-scope.md
architecture.md
dependencies.md
concurrency.md
api-shape.md
comments.md
errors.md
coupling.md
developer-experience.md
invariants.md
observability.md
naming.md
style.md
tests.md

详细介绍

深度审查

使用更全面的透镜集运行 /review-diff 技能的流程。 如果无法使用 review-diff,请告知用户并停止。

在其 Lenses 步骤中,阅读变更集并判断以下主题中哪些与之相关。透镜集包括:

  • review-diff 的标准透镜,使用 strong 层级,并通过其目录中的绝对路径指定;
  • 始终应用下的每个主题,以及与变更匹配时应用下所有符合变更情况的主题, 使用 cheap 层级。将主题文件的绝对路径作为透镜传入。

其他所有步骤均遵循 review-diff:模型、启动、检查、分类、修复和报告。 cheap 层级的主题审查器会产生较多噪声,因此检查步骤对它们最为重要。

始终应用

  • 命名 — 标识符
  • 风格 — 冗余内容、常量、顺序、局部性
  • 注释 — 注释、文档、附近过时的注释

与变更匹配时应用

  • API 形态 — 公共函数、类型、端点、事件、持久化格式
  • 架构 — 模块、层次、状态或副作用的归属
  • 变更范围 — 一个 PR 中包含多项功能、重构或清理
  • 并发 — 共享可变状态、线程/协程、计时器
  • 耦合 — 模块边界、连接、跨组件 API
  • 依赖项 — 清单、锁文件、供应商代码或生成代码、新库
  • 本地 CI — CI、构建、代码检查或代码生成步骤
  • 错误 — 新增或更改的失败路径、错误类型、panic
  • 不变量 — 验证、状态转换、持久化、聚合
  • 可观测性 — 日志、指标、日志记录或被吞掉的失败
  • 测试 — 测试、测试夹具、替身或测试辅助工具

评论

支持 Markdown