| name | code-review |
| description | 代码修改后的全局兼容审查与质量保障。Use when: 代码变更后需要全局兼容性检查、前后端适配验证、Bug 审查、代码质量把控。Covers: compatibility check, frontend-backend sync, bug review, code quality assurance, regression prevention. |
代码修改全局审查
每次代码修改后，执行系统化的全局兼容性检查、前后端适配验证与 Bug 审查，确保代码高质量且无遗漏。
触发时机
- 任何功能新增、修改或删除
- 接口变更（请求/响应结构、参数、状态码）
- 数据模型或数据库结构变更
- 依赖升级或配置修改
- 样式、布局或组件结构调整
审查流程
第一步：变更影响分析
- 明确本次修改涉及的所有文件
- 梳理修改点的上下游依赖关系（谁调用了它、它调用了谁）
- 列出可能受影响的模块和功能
第二步：前后端接口适配
- 若后端接口有变更（路径、参数、响应结构、状态码），前端调用处必须同步更新
- 若前端请求格式有变更，后端接收与校验逻辑必须同步适配
- 检查接口的错误处理是否前后端一致（错误码、提示信息、异常兜底）
- 验证数据类型在前后端传递过程中是否保持一致（避免类型隐式转换问题）
第三步：全局兼容性检查
- 类型安全：检查修改是否引入类型不匹配、空值未处理、越界访问
- 引用完整性：所有引用该模块/函数/变量的地方是否已同步更新
- 配置一致性：环境变量、路由配置、权限配置等是否同步修改
- 数据流完整性：数据从输入到存储到展示的完整链路是否通顺
- 边界条件：空数组、空对象、undefined、null、超长字符串、并发场景
第四步：Bug 排查清单
针对每个修改点逐项检查：
第五步：代码质量检查
第六步：输出审查报告
完成审查后，输出如下格式的审查结论：
## 审查结论
**修改范围**：（涉及的文件与模块）
**前后端适配**：✅ 已同步 / ⚠️ 需补充（说明）
**兼容性**：✅ 无破坏性变更 / ⚠️ 存在风险（说明）
**Bug 风险**：✅ 未发现 / ⚠️ 发现问题（逐条列出）
**代码质量**：✅ 达标 / ⚠️ 建议优化（说明）
**需要额外修改的文件**：（列出需同步修改的文件及原因）
原则
- 宁可多查一遍，不漏一个问题
- 修改一处，全局验证，杜绝连锁 Bug
- 前后端视为一个整体，接口变更必须双向同步
- 审查发现的问题必须当场修复，不留待办
