3.8 KiB
3.8 KiB
Reflection Index
Use this index for second-order workflow lessons.
| Date | Reflection | Trigger | Action | Detail |
|---|---|---|---|---|
| 2026-09-08 | 双数据库只读适配必须验证实际Spring装配 | 单库SQL测试通过但真实双库平台查询误用Booking JdbcTemplate返回503 | 显式绑定主dataSource、自建仓储私有组件，补两个数据源且唯一公共JdbcTemplate属于Booking的接线测试 | Case |
| 2026-08-21 | 本地前端运行必须以主项目和单一启动入口为准 | 5178多次因临时worktree、PID或隐藏启动变量变化重新出现登录页 | 主项目固定dev:5178，本机DEV端口自身识别免登录；交还前核对cwd和真实登录跳转，后端不可用只显示服务状态 |
Case |
| 2026-08-20 | 产品视觉验收必须逐个真实入口检查外壳、内容和卡片 | 根地址自动转到回放，首轮重复检查回放并把两个详情的白色外壳误报成整个产品已统一；用户指出四个列表仍是旧样式 | 以后按用户可见路由矩阵逐页实图；分别判断外壳、主题变量、卡片拓扑和真实链接，构建/组件测试不能替代页面级视觉验收 | Case |
| 2026-08-18 | 本地全链运行时重启必须整体校验端口、酒店身份、数据库和双Agent配置 | 同一酒店身份变量遗漏在第二次运行时刷新中复发；本次由postflight在交还前发现，未影响任务/数据 | 人工重启也必须使用显式变量清单并硬核对listener、auth/me、8082/5178指定酒店capabilities、旧replay和五项队列；自动检查器升为高优先级候选 | Case |
| 2026-08-14 | 字段审计必须同时问清共享对象的含义与页面位置 | 用户先指出邮件字段不可见，再纠正“拼装”不是工作台结果或回复草稿，而是任务卡后的一次邮件样式还原 | 后续字段清单显式写“数据、位置、重复范围、原文动作”；模糊名词先落成页面结构再记录 | Case |
| 2026-08-13 | 项目记录请求不能自动扩大为实施授权 | 两次把“更新项目信息”误解为页面实施或错误字段语义 | 默认锁定文档范围；结构化映射逐列复述；撤回决定保留 Withdrawn→Superseded 链 | Case |
| 2026-08-10 | 跨层 Agent 架构必须写入单一契约与项目记忆 | Layer 3 Recovery/Parsing 与 Layer 5 Booking职责多次漂移 | 编码前强制读取ADR/Data Flow/CR；中立结构不得提前变成Trace/部门；Prompt不复制系统门禁 | Case |
| 2026-08-10 | 业务分类不能由渠道捷径覆盖 | 用户纠正 QBD/LIAN TAI 等渠道固定 Group/FIT 例外 | 固化跨渠道 4/5 fixtures、拒绝非空 override，并让多 segment 在合并前保持 null | Case |
| 2026-08-11 | 来源别名不能被复制成真实姓名，字段修正也不能擅自重构布局 | 用户撤销 group_code → FIT Name 后，又纠正误加的“当前订单 / 邮件目标”对比布局 |
统一 canonical group_code、保持 Name 独立且空值不猜；FIT Update 保持单卡，增加负向布局与旧草稿版本测试 |
Case |
When To Reflect
Create a reflection only when work reveals a reusable lesson: skipped gates, repeated mistakes, durable debugging patterns, ineffective plans, human corrections, or candidates for new scripts or skills.
Routine task completion belongs in 30-worklog/task-history.md.