docs: 新增铁律19-22(Bug #698 教训)

- 铁律19: 编译错误不区分来源
- 铁律20: 数据来源必须验证
- 铁律21: 外部配置值必须实测验证
- 铁律22: 端到端验证必须有实际输出证据
This commit is contained in:
2026-06-10 09:12:00 +08:00
parent 7b1777a91e
commit ada67eb9c0

View File

@@ -106,6 +106,32 @@
- 每次修改后必须 `mvn clean compile -DskipTests` 验证
- **违规判定**: 因修改导致原有代码编译失败或运行报错视为违反铁律18必须立即回滚修复
**铁律19: 编译错误不区分来源Bug #698 教训)**
- `mvn compile``vite build``vue-tsc` 等构建命令报错 = 不过关,**不管是自己引入的还是历史遗留的**
- 禁止说"这是预存问题""不是我改的""原有bug"——构建通不过就不能宣称完成
- 正确做法:定位错误 → 修复 → 重新构建确认通过 → 然后才能继续
- **违规判定**: 构建命令有 ERROR 但未修复就报告"编译通过",视为违反铁律
**铁律20: 数据来源必须验证Bug #698 教训)**
- 涉及数据查询/提取时,必须先确认数据实际存储位置,不能假设
- 案例:从 `raw_steps_html` 提取 fileID而不是从 `steps`(纯文本,已被 strip
- 修复前必须:打印/检查原始数据结构 → 确认字段存在 → 再写提取逻辑
- 禁止:凭代码推断数据位置、假设"应该在这里"
**铁律21: 外部配置值必须实测验证Bug #698 教训)**
- 使用外部服务API、模型、数据库的配置值必须实际调用验证不能仅凭记忆或推测
- 案例:模型名 `mino-v2.5` 应为 `mimo-v2.5`,拼写错误导致 400
- 配置变更后必须:发起一次真实请求 → 确认返回 200 → 再宣称配置正确
- 禁止:改完配置不测试、假设"应该能用"
**铁律22: 端到端验证必须有实际输出证据Bug #698 教训)**
- 声称功能生效前,必须有实际的端到端输出证据
- 不能仅凭代码路径推断"应该走了 vision"——必须看到实际返回内容
- 验证方式:运行命令 → 检查输出中包含预期关键词(如 vision 分析结果、图片识别文字)
- 禁止:只检查代码路径可达就算"验证通过"
### 🟡 P1 铁律 — 强烈建议
**铁律9: 先分解再行动**