iterate-lessons-log

经验记录

经验记录条目以一种对未参与其中的未来团队有用的形式，记录项目、事件或经历中重要的经验。与回顾（侧重于团队改进）不同，经验记录侧重于超越单个团队的组织知识：模式、反模式和来之不易的经验。

适用场景

• 完成重要项目或计划之后
• 发生重大事件、服务中断或故障之后
• 意识到有重要信息值得让他人了解时
• 发现某种反复出现的模式之后
• 经验丰富的团队成员离开时（记录他们的知识）
• 在事后复盘期间，保留经验教训

不适用场景

• 你正在主持团队仪式本身 -> 使用 iterate-retrospective；此技能用于记录能长期留存的条目
• 你正在根据结果决定是否改变方向 -> 使用 iterate-pivot-decision
• 这项经验是实验结果总结 -> 先使用 measure-experiment-results，再在此处记录可迁移的经验
• 你正在向利益相关者汇报学到了什么 -> 使用 foundation-stakeholder-update

说明

收到创建经验记录条目的请求时，请按以下步骤操作：

1. 选择一个描述性标题 撰写一个便于搜索相关主题的标题。加入描述情境和经验的关键词。避免使用“项目 X 经验”这类笼统标题。

2. 提供背景信息 充分说明具体情况，让未参与其中的人也能理解。包括项目、时间线、团队和任何相关限制。未来的读者需要这些背景信息来判断经验是否适用。

3. 描述发生了什么 如实记录发生的事情。具体说明采取的行动、做出的决定和观察到的结果。避免归咎于个人；重点关注事件和系统。

4. 提炼经验 清楚阐述学到了什么。经验应当可付诸行动，让他人能够应用。区分观察到的事实与对其重要性的解读。

5. 制定建议 为面临类似情况的未来团队提供具体指导。他们应该怎么做？应该避免什么？应该提出哪些问题？

6. 界定适用范围 帮助读者了解这项经验何时适用。哪些情况会使其相关？哪些背景因素会影响其适用程度？

7. 添加便于搜索的标签 添加关键词和类别，帮助未来的搜索者找到此条目。想想面临类似情况的人会搜索什么。

输出格式

使用 references/TEMPLATE.md 中的模板来组织输出。完整条目应填写模板的每个部分：元数据；摘要；背景信息；发生了什么；经验教训；建议；适用范围；佐证材料；标签和类别；以及审查与更新。

质量检查清单

定稿前，请确认：

• 标题描述清晰，便于搜索
• 背景信息足够完整，让未参与其中的人也能理解
• 经验阐述清晰且可付诸行动
• 建议具体明确，不含糊
• 条目内容完整，无需依赖外部背景
• 标签有助于日后查找

示例

完成示例请参见 references/EXAMPLE.md。