开发与工程 code-reviewgitsubagentsfowler-smellsspec-check

双维度代码审查

通过并行子代理,同时审查代码是否符合项目标准和原始需求,输出并排报告。

FollowSkills 评估 · FSRS-2.0
不推荐
53/ 100 五分制 2.7 / 5
1 2 3 4 5 6
1信任安全16 / 25 · 3.2/5

技能定义清晰,仅执行本地git命令和读取仓库文件,无网络外传或敏感数据处理。但未提供用户确认机制(如调用前确认),子代理可能自动运行,且依赖外部issue-tracker文档(setup脚本),存在一定不可控性。因此授予16分。

2可靠稳定6 / 20 · 1.5/5

流程步骤明确,包含错误处理(如固定点解析失败及空diff检查)。但静态审查无法执行,且依赖外部issue-tracker文档的可用性,未提供测试或验证手段。授予6分。

3适用触发10 / 15 · 3.3/5

技能的目的和范围清晰,能区分标准与规格审查,并对无规格情况有处理。但未明确声明非适用场景,且未考虑中国网络环境(依赖GitHub等海外服务)。授予10分。

4规范维护12 / 15 · 4.0/5

有清晰的文档结构,包含过程、子代理提示、聚合步骤。但缺少安装/依赖说明,无版本历史或更改日志,维护责任未明确。授予12分。

5有效结果6 / 15 · 2.0/5

核心任务(审查差异)有明确步骤,产出结构清晰(并行报告)。但静态审查无法验证实际输出质量,且依赖外部文档(issue-tracker.md)存在不确定性。授予6分。

6证据核验3 / 10 · 1.5/5

技能本身没有测试或可验证的示例。README提供了仓库背景,但无具体审查案例。静态审查无法进行独立验证。授予3分。

证据充分度: 评估于 2026年8月7日 审查版本 84fdeffd12f2
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 该技能依赖外部issue-tracker文档(如GitHub、Linear),可能无法从中国大陆网络访问,影响实际使用。
  • 技能未提供用户确认机制,子代理可能自动并行运行,建议在执行前进行确认。
  • 静态审查无法验证实际输出质量,建议在实际环境中试用后再评估。
评估证据 [1][2][3][4][5][6]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

此技能对自固定提交点起的代码变更进行双维度审查:标准维度检查代码是否符合仓库的编码规范及 Fowler 代码坏味道基线;规格维度检查代码是否忠实实现了原始 issue 或 spec。两个维度并行运行于独立子代理,避免上下文污染,最后汇总为分开的报告。它内置了 12 种 Fowler 坏味道基线,并优先遵循仓库文档规范。适用于分支、PR 或进行中的工作。

此技能会确定用户指定的固定提交点(commit SHA、分支、标签等),并运行 git diff <fixed-point>...HEADgit log。它查找规格来源(issue 引用、用户参数、spec 文件),并识别标准来源文件。然后,它向两个并行子代理提供提示:一个检查标准违规和坏味道,另一个对照规格检查缺失、额外或不正确的实现。最后,它汇总两份报告并给出每轴的摘要。

  1. 当开发者想要在合并前审查一个 PR 或分支时,该技能会自动识别固定点(如 `main`)并启动双轴审查。
  2. 当用户要求“自 X 起审查更改”时,其中 X 是提交 SHA、标签或 `HEAD~5`。
  3. 当存在多个待审 PR,且需要快速并行评估标准和规格符合性时。
  4. 当产品经理希望验证实现是否符合 PRD,而工程负责人希望检查代码规范时。

这个 Skill 有哪些优点和局限?

优点
  • 并行子代理避免上下文污染,提高审查精度。
  • 内置 Fowler 坏味道基线,即使在无文档的仓库也能提供有用的检查。
  • 双轴分离防止标准合规掩盖需求偏差。
  • 明确的流程:确认固定点,查找规格源,并清晰指示子代理。
局限
  • 需要用户指定的固定点;若不明确,必须提示,增加了初始交互。
  • 若没有可用规格,规格轴将被跳过,可能偏离原始需求。
  • 需要仓库中有 `docs/agents/issue-tracker.md` 才能获取 issue,缺失时需要先运行设置命令。
  • 坏味道是启发式的判断,可能因主观性导致误报。
  • 此技能是在一个更大的仓库中分发的,安装它需要整个收藏,而不只是这一个技能。

如何安装这个 Skill?

运行 npx skills@latest add mattpocock/skills 并从交互式选择中选择此技能(确保选择 /setup-matt-pocock-skills)。随后运行 /setup-matt-pocock-skills 以配置 issue tracker 等。

如何使用这个 Skill?

在已配置的仓库中,提示例如:“审查 feature/login 分支”或“自 HEAD~3 起审查更改”。如有需要,指明固定点(若不指定,技能会询问)。该技能需要访问 docs/agents/issue-tracker.md;若缺失,它会提示运行设置命令。

常见问题

需要访问外部网络吗?
不需要。它仅使用本地 git 命令和文件系统。访问 issue tracker 是通过本地工作流(`docs/agents/issue-tracker.md`)完成的,并不直接连接 GitHub 或 Linear。
如果仓库没有规范文档会怎样?
标准轴仍会应用 Fowler 坏味道基线,因此即使没有显式规范,也能提供审查。显式文档中的规范会覆盖基线,工具已强制的内容会被跳过。
如果我不提供固定点会怎样?
技能会要求你提供。它不会自动假设 `main`;你需要指定一个提交 SHA、分支、标签或范围。

同仓库的其他 Skills

均来自 mattpocock/skills

相关 Skills