Skip to content

Diff 审查

Diff 审查用于确认 AI 修改范围是否符合需求。正式项目中,推送测试、提交 Git 和发布生产前都应检查 diff。

看哪几类 diff

Diff说明
SuccApp 本地变化 diff本地文件相对服务器基线的变化,决定推送测试服务器的内容。
SuccApp 远端变化 diff服务器相对本地 mirror 的变化,决定是否需要先拉取或处理冲突。
Git diff本地文件相对 Git 版本的变化,决定提交和评审内容。
文件历史 diff当前版本与服务器历史版本的差异,适合排查回退和丢失修改。

SuccApp diff 和 Git diff 关注的问题不同,不能互相替代。

审查重点

  1. 是否只修改了需求相关文件。
  2. 是否出现无关格式化、大段重排或排序变化。
  3. 是否误删目录级 .meta、资源文件或脚本。
  4. 是否修改了稳定标识,例如字段名、组件 ID、数据集 ID、动作节点 ID。
  5. 是否修改了权限、流程、数据范围、数据源或系统设置。
  6. 是否包含 .succapp/remote/、缓存、日志、临时文件或未确认的 AI 草稿。
  7. 是否有远端变化或冲突未处理。

CLI 和 VS Code 用法

CLI:

bash
succapp workspace status
succapp workspace status --json
succapp workspace file diff path/to/file
git diff

VS Code:

  1. 打开 SuccApp 变化 视图。
  2. 点击变化文件或选择 与服务器版本对比
  3. 打开 Git 视图检查 Git diff。
  4. 对高风险文件查看服务器文件历史。

AI 自查提示词

text
请审查当前本地变化,按文件说明修改原因。
重点检查是否有无关格式化、误删、.meta 异常、稳定 ID 变化、权限/流程/数据范围风险。
不要继续修改文件。

AI 的自查结论只能作为参考,最终仍应由项目成员查看 diff。

微信公众号微信公众号:山川软件