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