用途:对当前分支做多视角代码审查。六个专门视角并行工作——安全、正确性、约定、测试、架构、重复——每条发现随后都交给一个验证者,验证者默认它是错的,直到被证明为止。资料强调验证才是重点:未经核验的并行审查只会产出六段看似合理的噪音。
使用方式:先解析脚本路径,再交给 Workflow 工具:
echo ${CLAUDE_PLUGIN_ROOT}/skills/squad-review/scripts/workflow.js
Workflow({ scriptPath: "<the path printed above>", args: { scope: "<git command>", label: "<human description>" } })
范围由使用者自行判断,不要弹菜单:功能分支且有提交时用 git diff main...HEAD(常规情况);在 main 上或只有未提交改动时用 git diff HEAD;有相关未跟踪文件时在 label 中指名,让审查者完整阅读,因为 diff 不会显示它们;无可审查内容时说明并停止,不要启动工作流。只有当两个范围都内容可观且确实无法判断用户意图时才询问;用户已指定范围就直接使用。
报告结果:发现已排序并验证完毕,按严重程度而非视角分组呈现——视角只是元数据,不是结构。先列阻塞项。每条发现给出 file:line、破坏点与修复方向。三个字段决定审查是否可信,且都必须传达给用户:refuted,用一行说明数量和原因,这个数字是验证发生过的证据,隐藏它会让本技能看起来像其他普通审查;unverified,验证者未对其作出裁定的发现,必须放在单独标题下,不得并入发现列表;lenses_failed,非空表示审查不完整,要指出失效的视角,绝不能把部分审查当作健康证明。不要重新排序或弱化验证者已确认的内容,未经要求也不要写入文件。
限制:需要 Claude Code 的 Workflow 工具。该技能也通过仓库的 pi.skills glob 分发到 Pi,但那里没有该工具,因此不会运行——这是预期的失败,而不是静默降级为更弱的方案。