claude-skills Retrospectives实战：用complete-epic做好回顾-开发者社区

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	安装与上手指南