# 项目经理经验与教训

> 状态：当前有效  
> 用途：记录流程、协作、文档组织、规则执行、上下文管理方面的可复用教训。

## 2026-06-01｜外部参考源码必须沉淀成索引入口

- 触发：Boss 追问“让你把 AltTab 源代码分析之后，梳理一份索引文档，你做了吗？”
- 失误：此前只形成了 Space、截图、布局等分主题调研，没有建立一个遇到问题时可直接按图索骥的 AltTab 源码总索引。
- 原因：把“完成技术调研”等同于“建立可复用排查入口”，遗漏了后续研发排障场景的检索需求。
- 改进：以后对成熟竞品 / 参考源码做预研时，除专题结论外，必须同步产出源码索引；后续遇到同类问题时，先查索引，再定位源码，再记录 Aligner 是否采用。
- 关联：`01-I/04.coding/tech-pre-study/AltTab源码索引.md`、`AGENTS.md` 的“参考源码排查规则”。

## 2026-06-04｜不把待验证假设包装成执行方案

- 触发：用户指出 Space Lane 优化中，AI 提出“真实窗口截图拼图”替代真实 Space 截图，但没有明确该方案可能造成陌生画面，也没有说明是否在等待用户决策。
- 失误：把未经视觉和技术验证的合成截图方案当成可执行方向，弱化了“用户必须瞬间识别真实 Space”的产品目标。
- 原因：过早从实现便利性出发收敛方案，遗漏了等待决策需显式说明的协作规则和设计中“降级缩略图不能伪装成真实截图”的约束。
- 改进：以后涉及用户识别、原生感、真实截图等高感知 UI 方案时，先定义可验收的真实性标准；未验证前只能作为技术探索，不得直接进入实现计划。若需要用户裁决，必须明确写出正在等待什么决策。
- 关联：`/Users/ar/.codex/AGENTS.md` 的 Waiting For User 规则、`DESIGN.md` 的缩略图规则。