用途
Local Diff Review(提交前本地评审)用于在提交 PR 之前,对本地 git diff 做一轮与 PR review 同等标准的自检评审。核心原则是:审查标准必须与 pr-review 保持一致,不允许自定义弱化标准;先审查再改代码,默认先输出问题清单,只有用户明确要求才改代码;结论必须可执行,每个问题都要给出文件路径、行号、风险说明、修复建议。
主要能力
审查标准来源为两份文档:代码质量标准(./code-quality-standards.md)与常见问题清单(./common-issues-checklist.md)。说明中强调,本 skill 的评审准则以 pr-review 当前版本为准,以上链接即唯一标准来源。
支持的审查范围(diff 范围)包括:
- 未暂存改动:
git diff - 已暂存改动:
git diff --staged - 工作区全部改动(含暂存+未暂存):
git diff HEAD - 当前分支相对基线分支(推荐用于“准备提 PR”):
git diff upstream/<base-branch>...HEAD - 指定提交:
git show <commit>
审查时按文件分组梳理改动目的,依次执行三维度审查,并标注问题等级:🔴 严重问题(必须修复)、🟡 建议改进(建议本次修)、🟢 可选优化(可后续处理)。同时汇总回归风险:i18n、类型安全、边界行为、兼容性、性能影响,并给出审查结论(可合并 / 需修改后再审)。
使用方式
信息收集流程:先收集仓库状态,包括 git status --short、git branch --show-current、git remote -v,再根据用户意图选择 diff 范围,默认优先问清楚范围。
输出格式建议:
- 变更概览:审查范围(哪一种 diff)、涉及文件数、核心模块。
- 问题清单:每个问题包含文件路径 + 行号、风险等级(🔴/🟡/🟢)、问题描述(为什么是问题)、修复建议(给出可落地方案)。
- 总体结论:是否建议现在提 PR、提 PR 前建议补做的最小验证(如 lint / typecheck / 相关测试)。
评审时的行为约束:不凭空猜测业务意图,证据不足时明确“需用户确认”;不把“个人偏好”当成阻塞项;不为不存在的调用路径添加过度防御性建议;与用户沟通时优先中文、结论清晰、步骤可执行。
适用场景
- 用户希望“先本地 review,再提 PR”。
- 用户给出“review 我当前改动/本地 diff/暂存区改动/分支差异”。
- 用户希望获得与 PR review 同等级别的风险分级反馈。
常用触发语句示例:“请按 PR 标准 review 我本地当前改动。”“请 review 我的 git diff --staged,只给问题清单。”“请按 FastGPT 规范审查我当前分支相对 upstream/v4.14.7-dev 的改动。”
限制
资料未提供该技能的具体实现语言、安装方式、运行环境依赖、支持的 git 托管平台范围、定价或授权信息,暂未提供。审查标准的实际内容依赖外部文档 ./code-quality-standards.md 与 ./common-issues-checklist.md,本资料未给出其细节。