5821d73291
包含： - furniture-3d-system：Next.js 16 全栈应用（资产中心、产品管理、3D装配动画） - autocad-plugin：AutoCAD 家具导出插件源码 - 资产中心改造：编辑弹窗化、删除功能、Toast反馈、自定义Select组件 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
规范审查清单
适用范围：D:\AI Code\3danzhuang 当前仓库的默认开发流程、自检，以及交付前的规范审查阶段。
目标：把“规则要记住”改成“交付前必须显式检查”，降低做到后面把规则忘光的概率。
1. 这份清单给谁用
- 开发 Agent：开始前激活规则，交付前做自检
- 规范审查阶段：按它判断是否放行
- 安全 / 性能 / QA 审查：需要补充时，按它对齐结论口径
2. 开始干活前，先确认 4 件事
- 这次任务主要属于哪个角色
- 这次要遵守哪些标准文件
- 这次是不是在修根因，而不是只绕过去
- 这次改完后要经过哪些审查
如果这 4 件事说不清，先不要开做。
3. 企业级架构红线
只要碰到下面任意一条，规范审查就应该直接 rejected：
- Route / Page 里直接写数据库访问，没有经过
Service/Repository - 业务规则偷偷塞到前端，导致前后端口径不一致
- 多表更新没有事务保护
- 错误处理、响应格式各写各的，没有统一口径
- 为了赶进度，临时加特判，但没有收回到正式链路
白话理解：
“该分层的没有分层，该统一的没有统一，该兜底的没有兜底。”
4. 统一视觉红线
只要碰到下面任意一条，规范审查就应该直接 rejected：
- 明明已有
src/components/ui元组件，却重新手搓一套 - 直接使用不受控的原生控件，绕开已有视觉体系
- 颜色、圆角、阴影、间距明显不在统一设计令牌内
- 页面结构、交互反馈、按钮层级明显不符合现有苹果风格标准
- 为了“先能用”，临时拼出一版样式，却没有回归统一视觉规范
白话理解：
“不是做出来就算完成，而是要看起来像同一个产品。”
5. 根因修复红线
只要碰到下面任意一条，规范审查就应该直接 rejected：
- 只是压报错、绕校验、关功能，没有修真正的链路问题
- 只针对当前这个 SKU / 当前这一个例子加特判，没有抽象成通用逻辑
- 修复后没有最小验证，无法证明真的生效
- 明知问题在数据源 / 坐标系 / 分层边界 / 生命周期，却只在界面上打补丁
白话理解：
“看起来不报错，不等于问题解决了。”
6. 交付最少要带什么
每次交付至少要说明：
- 改了哪些文件
- 这些改动是为了解决什么问题
- 最小验证怎么做、结果是什么
- 自检是否通过以下三项：
- 遵守了适用标准
- 这次是根因修复，不是临时补丁
- 是否说明了影响范围和风险
7. 规范审查输出模板
建议统一按这个结构输出：
- 结论：
passed/passed with warnings/rejected - 审查范围：这次看了哪些文件、哪些链路
- 问题列表：按严重度排序
- 每个问题必须包含：
- 文件路径 + 行号
- 违反了哪条标准
- 白话解释
- 修复建议
- 最小放行条件：做到什么程度才能放行
8. 什么时候追加其他审查
下面这些情况，除了规范审查以外，还应该补充其他审查：
- 认证、鉴权、上传、外部输入处理 → 补安全审查
- 查询、分页、缓存、渲染性能、3D 场景性能 → 补性能审查
- 用户关键操作链路、历史 bug 回归、复杂交互变更 → 补 QA 验证
白话理解：
规范审查是必做；安全 / 性能 / QA 按风险追加，但不要漏掉真正高风险的链路。