主题
Diff 审查
Diff 审查用于确认 AI 修改范围是否符合需求。正式项目中,推送测试、提交 Git 和发布生产前都应检查 diff。
看哪几类 diff
| Diff | 说明 |
|---|---|
| SuccApp 本地变化 diff | 本地文件相对服务器基线的变化,决定推送测试服务器的内容。 |
| SuccApp 远端变化 diff | 服务器相对本地 mirror 的变化,决定是否需要先拉取或处理冲突。 |
| Git diff | 本地文件相对 Git 版本的变化,决定提交和评审内容。 |
| 文件历史 diff | 当前版本与服务器历史版本的差异,适合排查回退和丢失修改。 |
SuccApp diff 和 Git diff 关注的问题不同,不能互相替代。
审查重点
- 是否只修改了需求相关文件。
- 是否出现无关格式化、大段重排或排序变化。
- 是否误删目录级
.meta、资源文件或脚本。 - 是否修改了稳定标识,例如字段名、组件 ID、数据集 ID、动作节点 ID。
- 是否修改了权限、流程、数据范围、数据源或系统设置。
- 是否包含
.succapp/remote/、缓存、日志、临时文件或未确认的 AI 草稿。 - 是否有远端变化或冲突未处理。
CLI 和 VS Code 用法
CLI:
bash
succapp workspace status
succapp workspace status --json
succapp workspace file diff path/to/file
git diffVS Code:
- 打开 SuccApp 变化 视图。
- 点击变化文件或选择 与服务器版本对比。
- 打开 Git 视图检查 Git diff。
- 对高风险文件查看服务器文件历史。
AI 自查提示词
text
请审查当前本地变化,按文件说明修改原因。
重点检查是否有无关格式化、误删、.meta 异常、稳定 ID 变化、权限/流程/数据范围风险。
不要继续修改文件。AI 的自查结论只能作为参考,最终仍应由项目成员查看 diff。
