claude-skills Retrospectives实战：用complete-epic做好回顾
【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills
claude-skills 是一个为全栈开发者打造的 Claude Code 插件，内置 67 个专业技能与 9 条项目工作流。其中Retrospectives（回顾阶段）是工作流的收尾环节，核心命令complete-epic能自动校验工单完成情况、生成 12 章节的完成报告、归档文档并在 Jira 中关闭 Epic——一次命令，把整个项目的回顾做到位。
🧭 Retrospectives 是什么：工作流的最后一环
claude-skills 把项目开发拆成 4 个阶段，Retrospectives 排在最后：
| 阶段 | 干什么 | 代表命令 |
|---|---|---|
| Discovery | 调研、验证假设 | discovery:create |
| Planning | 制定 Epic 计划与实施方案 | planning:epic-plan |
| Execution | 逐张执行工单 | execution:execute-ticket |
| Retrospectives | 收尾、报告、复盘 | retrospectives:complete-epic |
阶段依赖关系定义在 commands/workflow-manifest.yaml 中：Retrospectives 阶段依赖 Execution 阶段完成，是整个生命周期中唯一"回望"的环节。它的价值在于——不只是把 Epic 标记为 Done，而是把架构变化、经验教训、技术债一次性沉淀成文档，供下一个功能迭代读取。
阶段总览见 docs/workflow/retrospective-phase.md。
⚡ complete-epic：一条命令完成 Epic 收尾
命令定义在 commands/project/retrospectives/complete-epic.md，输入只有一个 Jira Epic 键（如CC-62）。执行过程分为 5 个阶段，每个关键动作都有人工确认检查点，不会擅自改动 Jira 或 Confluence：
Phase 0：上下文获取从 Jira 拉取 Epic 与全部关联工单，在 Confluence 的/Epics/In Progress/{Epic_Key}/下定位 Overview 文档与实施计划。找不到文档会立即停下来向你索要链接；随后弹出"Epic 完成就绪"检查点，让你确认工单完成数量是否达标。
Phase 1：完成度校验逐一核对工单状态，识别未 Done 的工单与阻塞项，并审查实现质量（PR 是否合并、测试覆盖率是否达到 90% 目标）。存在未完成工单时会给出 A/B/C 三个选项（先补完 / 移入 backlog 后关闭 / 延期保留），由你决定。
Phase 2：生成 12 章节完成报告（下一节详述）
Phase 3：文档更新先向你展示"拟议变更"：把完成报告追加到 Overview 文档、把文档从/In Progress/移动到/Complete/Sprint [N]/、更新所有工单链接——确认后才动手。
Phase 4：发布与关闭把报告发布到 Confluence，将 Epic 状态置为 Done、Resolution 置为 Completed，并附上报告链接的评论。
Phase 5：知识转移识别可复用的模式，更新CLAUDE.md、架构决策记录（ADR）与团队最佳实践文档，让经验真正留下来。
📋 12 章节完成报告：复盘到底复什么
报告不是流水账，而是结构化的复盘框架，涵盖：
| # | 章节 | 回答的问题 |
|---|---|---|
| 1 | Epic 摘要 | 花了多久、实际 vs 计划点数、谁参与了 |
| 2 | 目标与成果 | 当初的目标达成了吗？业务影响多大 |
| 3 | 工单明细 | 每张工单的完成日期与偏差 |
| 4 | 技术交付物 | 文件数量、代码行、测试覆盖率 |
| 5 | 架构与设计决策 | 选了什么模式、为什么这么权衡 |
| 6 | 质量指标 | PR 评审时长、缺陷数量、钩子通过率 |
| 7 | 技术债与后续 | 欠了哪些债、已创建哪些跟进工单 |
| 8 | 测试与质量保障 | 测试有没有提前拦住问题 |
| 9 | 交付的文档 | Confluence 页面、README、Runbook 更新 |
| 10 | 经验教训 | 做得好的、待改进的、流程建议 |
| 11 | 风险评估回顾 | 计划风险 vs 实际影响、应对是否有效 |
| 12 | 对下个 Epic 的建议 | 规划 / 实现 / 测试各阶段的具体改进 |
第 10 章的"经验教训"和第 11 章的"风险回顾"是传统手工复盘最容易漏掉的部分，这里由 Agent 基于 git 历史、PR 数据和测试覆盖率自动提取。
🛡️ 检查点机制：人始终握有否决权
这是新手最容易忽略、也最值得点赞的设计：complete-epic 全程有 3 道强制检查点——
- 完成就绪确认：列出 Epic 键、工单统计与文档位置，你确认"是/否/查看明细"后才继续
- 文档更新确认：展示将要追加的确切内容和新路径，批准后才写入 Confluence
- 关闭 Epic 确认：明确告知将修改 Jira 状态和 Resolution，批准后才会关闭
完整检查点体系说明见 docs/WORKFLOW_COMMANDS.md 的 Checkpoint System 章节。这意味着即使交给 AI 自动执行，也不会出现"报告还没看、Epic 已经关了"的事故。
📌 实战使用步骤
- 确认 Epic 下所有工单已通过
execution:complete-ticket转入 Done - 在 Claude Code 中执行：
/project:retrospectives:complete-epic CC-62（换成你的 Epic 键） - 依次通过 3 道检查点，等待报告生成
- 检查输出摘要：故事点数、测试覆盖率、Top 3 经验教训、后续工单
- 若整个 Sprint 的多个 Epic 都收尾完毕，可继续执行
complete-sprint生成 Sprint 级回顾
💡 前置条件：工作流命令需要配置 Atlassian MCP 服务器来连接 Jira 与 Confluence，配置方法见 docs/ATLASSIAN_MCP_SETUP.md。
📚 延伸阅读：相关文件速查
| 文件 | 说明 |
|---|---|
| commands/project/retrospectives/complete-epic.md | 命令完整定义，含 5 个阶段与失败条件表 |
| commands/project/retrospectives/complete-epic.yaml | 命令的输入/输出/依赖声明 |
| docs/workflow/retrospective-complete-epic.md | 命令速览：输入、输出与前置条件 |
| docs/workflow/retrospective-phase.md | Retrospectives 阶段总览 |
| docs/WORKFLOW_COMMANDS.md | 9 条工作流命令的完整参考手册 |
| commands/project/retrospectives/complete-sprint.md | Sprint 级回顾生成器 |
| QUICKSTART.md | 安装与上手指南 |
✅ 小结
complete-epic把"收尾"从一件容易糊弄过去的事，变成有校验、有报告、有检查点的标准流程- 12 章节完成报告自动覆盖目标达成、质量指标、技术债与经验教训，复盘不再靠记忆
- 3 道强制检查点保证 AI 执行前你始终有一票否决权
- 生成的系统描述更新会喂给下一轮
feature-forge，让每次迭代都比上一次更"知情"
对新手来说，不必一次看懂全部工作流：先跑通 Planning 和 Execution，再用complete-epic体验一次完整收尾，整个 claude-skills 工作流的价值就一目了然了。
【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
