--- name: 0010-retrospective description: 闭环复盘，基于 Retro 模板进行总结 --- # 技能：闭环复盘 (Retrospective) ## 元数据 (Metadata) - **name**: retrospective - **description**: 闭环复盘，基于 Retro 模板进行总结 - **version**: 1.0.0 - **author**: SSOT Architect - **lastUpdated**: 2026-01-15 ## 触发与定位 (Triggers & Scope) ### 触发条件 (Triggers) 当以下情况发生时，AI 应当"觉醒"本技能： 1. **变更记录完成**: 完成变更记录后，需要进行复盘 2. **功能发布**: 功能发布后，需要进行复盘 3. **迭代结束**: Sprint 或迭代结束后，需要进行复盘 4. **问题发现**: 发现流程或模板问题，需要进行复盘 5. **工作流阶段 7**: 用户进入工作流的"闭环复盘"阶段 ### 定位范围 (Scope) - **适用模块**: 所有 Datai 项目模块 - **影响文件**: `docs/retros/YYYYMMDD-Review.md`, `docs/prompts/`, `CONTRIBUTING.md` - **相关技能**: skill-changelog-archiving, skill-verification-commit ## 核心指令集 (Instructions) ### 架构约束 (Architecture Constraints) 1. **Retro 必须包含**: - 目标 vs 结果指标对比 - 3 条有效 Prompt 模式 - 3 条踩坑与改进 - 模板更新记录 - 技能练习记录 2. **强制闭环规则**: - 如果发现 Prompt 效果不好 -> **必须**修改 `docs/prompts/` 下的对应文件 - 如果发现流程问题 -> **必须**更新 `CONTRIBUTING.md` - 不要只记录问题，要产生 Action Item 3. **反哺原则**: - 如果发现模板不适用，立即执行一次"模板更新" - 如果发现流程有问题，立即更新相关文档 - 如果发现技能有问题，立即更新技能文档 ### 业务逻辑 SOP (Business Logic SOP) #### 步骤 1: 目标 vs 结果指标对比 ```markdown ## 目标 vs 结果指标对比 ### 目标指标 | 指标名称 | 目标值 | 实际值 | 达成率 | 状态 | |----------|--------|--------|--------|------| | 开发时间 | 3 天 | 4 天 | 75% | ❌ 未达成 | | 代码覆盖率 | 80% | 85% | 106% | ✅ 超额达成 | | Bug 数量 | 0 | 2 | - | ❌ 未达成 | | 性能提升 | 50% | 60% | 120% | ✅ 超额达成 | ### 结果分析 #### 达成的指标 - [指标1]: [达成原因分析] - [指标2]: [达成原因分析] #### 未达成的指标 - [指标1]: [未达成原因分析] - [指标2]: [未达成原因分析] #### 超额达成的指标 - [指标1]: [超额达成原因分析] - [指标2]: [超额达成原因分析] ### 经验总结 [整体经验总结] ``` #### 步骤 2: 提取 3 条有效 Prompt 模式 ```markdown ## 3 条有效 Prompt 模式 ### 模式 1: [模式名称] **描述**: [描述该模式的有效性] **适用场景**: [适用场景] **示例**: ```markdown [Prompt 示例] ``` **效果**: [使用该模式后的效果] **原因**: [为什么该模式有效] ### 模式 2: [模式名称] **描述**: [描述该模式的有效性] **适用场景**: [适用场景] **示例**: ```markdown [Prompt 示例] ``` **效果**: [使用该模式后的效果] **原因**: [为什么该模式有效] ### 模式 3: [模式名称] **描述**: [描述该模式的有效性] **适用场景**: [适用场景] **示例**: ```markdown [Prompt 示例] ``` **效果**: [使用该模式后的效果] **原因**: [为什么该模式有效] ``` #### 步骤 3: 记录 3 条踩坑与改进 ```markdown ## 3 条踩坑与改进 ### 踩坑 1: [问题描述] **问题描述**: [详细描述问题] **影响**: [问题的影响] **根本原因**: [问题的根本原因] **改进措施**: [如何改进] **Action Item**: - [ ] [具体行动项1] - [ ] [具体行动项2] - [ ] [具体行动项3] **责任人**: [责任人] **截止日期**: [截止日期] ### 踩坑 2: [问题描述] **问题描述**: [详细描述问题] **影响**: [问题的影响] **根本原因**: [问题的根本原因] **改进措施**: [如何改进] **Action Item**: - [ ] [具体行动项1] - [ ] [具体行动项2] - [ ] [具体行动项3] **责任人**: [责任人] **截止日期**: [截止日期] ### 踩坑 3: [问题描述] **问题描述**: [详细描述问题] **影响**: [问题的影响] **根本原因**: [问题的根本原因] **改进措施**: [如何改进] **Action Item**: - [ ] [具体行动项1] - [ ] [具体行动项2] - [ ] [具体行动项3] **责任人**: [责任人] **截止日期**: [截止日期] ``` #### 步骤 4: 模板更新记录 ```markdown ## 模板更新记录 ### Prompt 模板更新 #### [PROMPT-XXX](../prompts/PROMPT-XXX.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] **更新前**: ```markdown [更新前的内容] ``` **更新后**: ```markdown [更新后的内容] ``` **效果**: [更新后的效果] ### ADR 模板更新 #### [ADR-XXX](../decisions/adr/ADR-XXX.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] **更新前**: ```markdown [更新前的内容] ``` **更新后**: ```markdown [更新后的内容] ``` **效果**: [更新后的效果] ### Session 模板更新 #### [Session-YYYYMMDD](../sessions/YYYYMMDD-TaskName.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] **更新前**: ```markdown [更新前的内容] ``` **更新后**: ```markdown [更新后的内容] ``` **效果**: [更新后的效果] ### Retro 模板更新 #### [Retro-YYYYMMDD](../retros/YYYYMMDD-Review.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] **更新前**: ```markdown [更新前的内容] ``` **更新后**: ```markdown [更新后的内容] ``` **效果**: [更新后的效果] ``` #### 步骤 5: 技能练习记录 ```markdown ## 技能练习记录 ### 练习的技能 #### [技能1](../skills/0001-skill-name.md) **练习内容**: [练习的具体内容] **练习效果**: [练习后的效果] **改进建议**: [对技能的改进建议] #### [技能2](../skills/0002-skill-name.md) **练习内容**: [练习的具体内容] **练习效果**: [练习后的效果] **改进建议**: [对技能的改进建议] ### 技能提升 #### 提升的技能 - [技能1]: [提升的具体内容] - [技能2]: [提升的具体内容] #### 新掌握的技能 - [技能1]: [掌握的具体内容] - [技能2]: [掌握的具体内容] #### 需要提升的技能 - [技能1]: [需要提升的具体内容] - [技能2]: [需要提升的具体内容] ``` #### 步骤 6: 流程改进建议 ```markdown ## 流程改进建议 ### 建议改进的流程 1. [改进建议1] - **当前问题**: [当前流程的问题] - **改进方案**: [改进方案] - **预期效果**: [预期效果] 2. [改进建议2] - **当前问题**: [当前流程的问题] - **改进方案**: [改进方案] - **预期效果**: [预期效果] 3. [改进建议3] - **当前问题**: [当前流程的问题] - **改进方案**: [改进方案] - **预期效果**: [预期效果] ### 需要更新的文档 #### [CONTRIBUTING.md](../../CONTRIBUTING.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] #### [README.md](../../README.md) **更新原因**: [为什么需要更新] **更新内容**: - [更新内容1] - [更新内容2] ``` #### 步骤 7: 创建 Retro 文档 ```markdown --- name: RETRO-20260115 description: 迭代复盘 --- # 迭代复盘: [复盘名称] ## 元数据 (Metadata) - **Date**: 2026-01-15 - **Review Type**: [Sprint Review/Feature Review/Process Review] - **Review Period**: [复盘周期] - **Participants**: [参与者] - **Related Requirements**: [REQ-XXX](../requirements/REQ-XXX.md) - **Related Session**: [20260115-TaskName](../sessions/20260115-TaskName.md) ## 目标 vs 结果指标对比 (Goal vs Result Metrics) ### 目标指标 | 指标名称 | 目标值 | 实际值 | 达成率 | 状态 | |----------|--------|--------|--------|------| | [指标1] | [目标值] | [实际值] | [达成率] | [状态] | | [指标2] | [目标值] | [实际值] | [达成率] | [状态] | ### 结果分析 [目标与结果的差异分析] ## 3 条有效 Prompt 模式 (3 Effective Prompt Patterns) ### 模式 1: [模式名称] [描述该模式的有效性] - **适用场景**: [适用场景] - **示例**: [示例] ### 模式 2: [模式名称] [描述该模式的有效性] - **适用场景**: [适用场景] - **示例**: [示例] ### 模式 3: [模式名称] [描述该模式的有效性] - **适用场景**: [适用场景] - **示例**: [示例] ## 3 条踩坑与改进 (3 Pitfalls and Improvements) ### 踩坑 1: [问题描述] - **问题描述**: [详细描述问题] - **影响**: [问题的影响] - **改进措施**: [如何改进] - **Action Item**: [具体行动项] ### 踩坑 2: [问题描述] - **问题描述**: [详细描述问题] - **影响**: [问题的影响] - **改进措施**: [如何改进] - **Action Item**: [具体行动项] ### 踩坑 3: [问题描述] - **问题描述**: [详细描述问题] - **影响**: [问题的影响] - **改进措施**: [如何改进] - **Action Item**: [具体行动项] ## 模板更新记录 (Template Updates) ### Prompt 模板更新 - [PROMPT-001](../prompts/PROMPT-001.md): [更新内容] - [PROMPT-002](../prompts/PROMPT-002.md): [更新内容] ### ADR 模板更新 - [ADR-001](../decisions/adr/ADR-001.md): [更新内容] ### Session 模板更新 - [Session-YYYYMMDD](../sessions/YYYYMMDD-TaskName.md): [更新内容] ## 技能练习记录 (Skill Practice) ### 练习的技能 - [技能1](../skills/0001-skill-name.md): [练习内容] - [技能2](../skills/0002-skill-name.md): [练习内容] ### 技能提升 [技能提升的总结] ## 流程改进建议 (Process Improvement) ### 建议改进的流程 1. [改进建议1] 2. [改进建议2] 3. [改进建议3] ### 需要更新的文档 - [CONTRIBUTING.md](../../CONTRIBUTING.md): [更新内容] - [README.md](../../README.md): [更新内容] ## 相关文档 (Related Documents) - [会话记录](../sessions/YYYYMMDD-TaskName.md) - [需求文档](../requirements/REQ-XXX.md) - [ADR 文档](../decisions/adr/ADR-XXX.md) ``` #### 步骤 8: 更新 docs/index.md ```markdown ### 🔄 迭代复盘 (Retros) | 文档 | 类型 | 日期 | |------|------|------| | [20260115-Review](retros/20260115-Review.md) | Sprint Review | 2026-01-15 | ``` ### 工具调用 (Tool Usage) 1. **文件读取工具**: - 使用 `Read` 工具读取现有模板 - 使用 `Read` 工具读取 `docs/index.md` 2. **文件更新工具**: - 使用 `SearchReplace` 工具更新模板 - 使用 `SearchReplace` 工具更新 `docs/index.md` 3. **文件创建工具**: - 使用 `Write` 工具创建 Retro 文档 ## 错误陷阱与验证 (Anti-Patterns & Checklist) ### 常见错误 (Anti-Patterns) 1. **错误**: 只记录问题，不产生 Action Item - **后果**: 问题无法解决，无法改进 - **修正**: 必须为每个问题产生具体的 Action Item 2. **错误**: 发现 Prompt 效果不好但不更新模板 - **后果**: 同样的问题会重复出现 - **修正**: 必须更新 `docs/prompts/` 下的对应文件 3. **错误**: 发现流程问题但不更新文档 - **后果**: 流程问题无法解决 - **修正**: 必须更新 `CONTRIBUTING.md` 等相关文档 4. **错误**: 不提取有效的 Prompt 模式 - **后果**: 无法积累经验，无法提升效率 - **修正**: 必须提取 3 条有效的 Prompt 模式 5. **错误**: 不记录踩坑经验 - **后果**: 同样的错误会重复出现 - **修正**: 必须记录 3 条踩坑与改进 ### 验收清单 (Acceptance Checklist) - [ ] 目标 vs 结果指标对比已完成 - [ ] 3 条有效 Prompt 模式已提取 - [ ] 3 条踩坑与改进已记录 - [ ] Action Item 已产生 - [ ] 模板更新记录已完成 - [ ] 技能练习记录已完成 - [ ] 流程改进建议已提出 - [ ] Retro 文档已创建 - [ ] 相关文档已更新 - [ ] docs/index.md 已更新 ### Correct vs Incorrect 对比 #### Correct 示例 ```markdown ## 3 条踩坑与改进 ### 踩坑 1: Prompt 缺少上下文链接 **问题描述**: Prompt 没有引用相关的需求文档和设计文档，导致 AI 无法理解上下文。 **影响**: 生成的代码不符合需求，需要多次修改。 **根本原因**: Prompt 模板缺少上下文链接字段。 **改进措施**: 在 Prompt 模板中添加"上下文链接"字段，强制要求引用相关文档。 **Action Item**: - [ ] 更新 docs/prompts/0000-template.md，添加上下文链接字段 - [ ] 更新所有现有 Prompt，补充上下文链接 - [ ] 在 Prompt 编写技能中强调上下文链接的重要性 **责任人**: SSOT Architect **截止日期**: 2026-01-20 ``` #### Incorrect 示例 ```markdown ## 问题 1. Prompt 缺少上下文链接 2. 代码风格不一致 3. 测试覆盖率不够 ``` **问题**: 只记录了问题，没有产生 Action Item，无法解决问题。 ## 相关文档 (Related Documents) - [工作流提示词](../prompts/03-创建工作流提示词.md#阶段-7-闭环复盘-retrospective) - [变更记录与归档技能](./0009-changelog-archiving.md) - [测试与版本提交技能](./0011-verification-commit.md) - [Retro 模板](../prompts/03-创建工作流提示词.md#44-retro--loop-模板-闭环复盘)