用途
经验教训日志（Lessons Log）用于把项目、事故或经历中的重要学习，记录成对未来团队有用的格式。与回顾会（retrospective）聚焦团队自身改进不同，经验教训日志聚焦超越单个团队的组织知识，沉淀可迁移的模式、反模式和来之不易的智慧。
何时使用
- 完成重要项目或计划之后
- 发生重大事故、中断或失败之后
- 意识到某些重要事情、且其他人也应知道时
- 发现反复出现的模式之后
- 有经验的团队成员离开时（保存其知识）
- 在事后复盘中保存学习成果
何时不使用
- 正在主持团队仪式本身：应使用 iterate-retrospective；本技能负责沉淀比仪式更持久的条目
- 正在根据结果决定是否改变方向：应使用 iterate-pivot-decision
- 学习内容属于实验读数：先使用 measure-experiment-results，再在此沉淀可迁移的教训
- 正在向利益相关者更新所学内容：应使用 foundation-stakeholder-update
使用方式
当被要求创建经验教训日志条目时，按以下步骤操作：
- 选择描述性标题：写一个搜索该主题的人能找到的标题，包含描述情境和学习的关�键词，避免“项目 X 的教训”这类泛化标题。
- 提供背景：充分解释情境，使未亲历者也能理解，包括项目、时间线、团队及相关约束。未来读者需要这些背景来评估适用性。
- 描述发生了什么：对发生的事做事实性叙述，具体说明采取的行动、做出的决策和观察到的结果，避免指责，聚焦事件与系统。
- 提炼教训：清晰表达所学内容，教训应可操作、可被他人应用，区分观察到的事实与对其重要性的解读。
- 制定建议：为未来面临类似情境的团队提供具体指导——应该做什么、避免什么、应提出哪些问题。
- 定义适用性：帮助读者判断该教训何时适用，哪些情境会触发相关性，什么背景会使其更适用或更不适用。
- 添加标签以便搜索：包含关键词和分类，帮助未来搜索者找到该条目，思考面临类似情境的人会搜索什么。
输出格式
使用 references/TEMPLATE.md 中的模板组织输出。完整条目需填写模板的每个部分：元数据、摘要、背景、经过、教训、建议、适用性、支持证据、标签与分类，以及评审与更新。
质量检查清单
定稿前确认：
- 标题具有描述性且可搜索
- 背景完整，足以让未亲历者理解
- 教训表述清晰且可操作
- 建议具体而非含糊
- 条目可独立成立（不依赖外部背景）
- 标签便于未来发现
示例
完整示例见 references/EXAMPLE.md。