用途:把“这次改动好不好”变成可重复的评审流程,并给出明确的合并或上线就绪结论。该技能合并三类审查视角:合并就绪度(需求对齐、风险、验证)、代码可维护性(Clean Code 风格)、文档与实现一致性。它是 Ship Faster 评审的统一入口,内置自动分流:始终运行统一评审;若检测到 React/Next.js 性能风险,追加运行 review-react-best-practices 并纳入结论;若检测到 UI 界面变更,追加 Web Interface Guidelines 审计(无障碍/焦点/表单/动效/内容溢出),以简洁的 file:line 形式输出。
输入(建议):BASE_SHA 与 HEAD_SHA 用于基于 diff 的评审;可选 PLAN_OR_REQUIREMENTS 路径;可选文档范围(README.md、docs/**、API 契约);可选 run_dir。
建议范围命令: BASE_SHA=$(git merge-base HEAD main 2>/dev/null || git merge-base HEAD master) HEAD_SHA=$(git rev-parse HEAD) git diff --stat "$BASE_SHA..$HEAD_SHA" git diff "$BASE_SHA..$HEAD_SHA"
流程:先做自动分流,依据改动文件路径与关键词决定是否追加专项审查;再进行合并就绪度检查(需求对齐、副作用是否受控、错误处理是否显式、是否有验证证据);随后做 Clean Code 可维护性扫描(命名、函数粒度、重复、过度设计、魔法值、结构清晰度、项目约定);最后做文档与代码一致性扫描,逐条核对 README、docs、配置示例、环境变量键与 API 契约,记录不一致及证据。
输出:生成 quality-review.md,可选 quality-review.json;在 Ship Faster run_dir 下写入 run_dir/evidence/ 对应文件;若触发 React/Next 性能审查或 UI 指南审计,也分别持久化对应文件。报告建议包含 Summary(结论:Ready / With fixes / Not ready)、Triage、Strengths、Issues(Critical/Important/Minor,含位置、原因、最小修复)、UI Guidelines(仅审计时)。
限制:资料未提供具体安装命令、收费方式、支持平台与效果数据;实际可用性取决于运行环境是否具备 git、WebFetch 或 curl 等能力。