第 12 章:回顾与反思 — 项目复盘
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)
(申请发送: agentupdate)
你将学到什么
- 用 gstack 的
/retro做项目回顾 - 用
/insights分析你的 Claude Code 使用模式 - 总结 gstack 和 superpowers 各自的强项
- 从教程项目到真实项目的迁移建议
12.1 为什么要复盘
做完项目直接开始下一个?等等。花 10 分钟复盘,能帮你:
- 发现哪些环节效率最高,哪些浪费了时间
- 理解 gstack 和 superpowers 各自擅长什么
- 为下一个项目积累经验
12.2 /retro — 项目回顾
命令语法
/retro
实战:NoteFlow 项目回顾
/retro
回顾 NoteFlow 项目的开发过程。
项目从第 1 章到第 11 章完成,使用了 gstack 和 superpowers 两套工具。
回顾维度:
mindmap
root((项目回顾))
做得好的
三角色审查发现多个盲点
设计系统让 UI 风格统一
subagent 自动编码节省大量时间
TDD 让重构有安全感
可以改进的
第一次用 gstack 时花时间摸索
/design-shotgun 生成的方案差异不大
搜索功能的边界测试不够全面
下次尝试的
用自定义 skill 封装工作流
尝试 /executing-plans 并行执行
引入 CI/CD 自动化典型回顾产出
做得好的(Keep):
- 三角色审查 — CEO 视角提出了"localStorage 5MB 限制"的问题,省了后面返工
- 设计系统先行 — CSS 变量定义好之后,所有组件风格自然一致
- subagent 编码 — 7 个任务 30 分钟完成,对比人工 1-2 天
- 测试安全网 — 搜索 bug 修复时,全量测试确认没有回归
可以改进的(Improve):
- gstack 学习曲线 — 第一次用不熟悉命令,花了额外时间摸索
- /design-shotgun — 生成的方案差异不大,选择困难
- 审查粒度 — 有些 review 意见过于严格(Suggestion 级别),浪费了修复时间
下次尝试的(Try):
- 创建自定义 skill 封装整个流程
- 尝试
/executing-plans对比速度差异- 引入虚拟滚动解决列表性能问题
12.3 /insights — 使用分析
命令语法
/insights
这个命令分析你的 Claude Code 使用数据,告诉你:
- 哪些命令用得最多
- 哪些环节花时间最长
- 有哪些可以优化的模式
典型 insights 结果
使用统计:
- 总会话数:23
- 总消息数:187
- 最常用命令:
/subagent-driven-development(8 次)- 花时间最长的环节:设计阶段(40%)
- commit 数:17
摩擦分析:
- 审查修复循环 — 平均每个任务有 1.3 次 review 修复循环
- 上下文管理 — 第 7 章后需要
/compact释放空间- 模型选择 — 简单任务用 sonnet 可以节省 30% 成本
建议:
- 为重复模式创建自定义 skill
- 在 CLAUDE.md 中明确代码风格规则,减少 review 意见
- 使用
/effort low处理简单任务
12.4 gstack vs superpowers:什么时候用哪个
经过 12 章的实战,总结一下两套工具各自擅长的场景:
flowchart TB
subgraph gstack["gstack 擅长"]
G1[需求碰撞
多角色审查]
G2[视觉设计
UI 方案生成]
G3[设计审查
自动修复视觉问题]
G4[发布协调
文档生成]
G5[项目回顾
使用分析]
end
subgraph superpowers["superpowers 擅长"]
S1[实施计划
任务拆解]
S2[自动编码
subagent 流水线]
S3[测试驱动
红灯绿灯重构]
S4[代码审查
质量把关]
S5[调试排错
科学方法]
end
gstack -.->|"设计稿交接"| superpowers
style gstack fill:#eef2ff,stroke:#4f46e5
style superpowers fill:#ecfdf5,stroke:#059669| 场景 | 用 gstack | 用 superpowers |
|---|---|---|
| 需求不明确 | /plan-ceo/design/eng-review |
— |
| 需要 UI 设计 | /design-shotgun + /design-html |
— |
| 需要写代码 | — | /subagent-driven-development |
| 需要写测试 | — | /test-driven-development |
| 需要代码审查 | /review(产品视角) |
/requesting-code-review(代码视角) |
| 遇到 bug | /investigate(性能问题) |
/systematic-debugging(逻辑 bug) |
| 需要发布 | /ship + /document-release |
/finishing-a-development-branch |
| 项目回顾 | /retro |
— |
12.5 从教程到真实项目
教程项目跟真实项目有几个关键区别:
| 维度 | 教程项目 | 真实项目 |
|---|---|---|
| 复杂度 | 功能简单,几个组件 | 功能复杂,几十个组件 |
| 团队 | 一个人 + AI | 多人协作 + AI |
| 时间线 | 一天完成 | 持续几周到几个月 |
| 代码量 | 几百行 | 几千到几万行 |
| 测试 | 覆盖核心路径 | 覆盖所有边界情况 |
迁移建议:
- CLAUDE.md 持续更新 — 真实项目的架构和约定会不断变化
- 先小后大 — 先在一个小功能上试 gstack+superpowers,再推广到整个项目
- 自定义 skill 是关键 — 为团队创建统一的 skill,确保流程一致
- 不要全盘 AI 化 — 复杂的架构决策和关键业务逻辑,人还是要参与
12.6 学到了什么
回顾 12 章的核心收获:
| 章 | 核心收获 |
|---|---|
| 1 | CLAUDE.md 是 AI 理解项目的基础 |
| 2 | 三角色审查帮你发现盲点 |
| 3 | 设计系统先行,UI 不拍脑袋 |
| 4 | 详细计划 = 顺利执行 |
| 5 | subagent 自动编码,30 分钟干 2 天的活 |
| 6 | TDD:先写测试再写代码 |
| 7 | 迭代开发中测试是安全网 |
| 8 | 双重审查:逻辑(superpowers)+ 体验(gstack) |
| 9 | 调试是科学实验,不是猜 |
| 10 | 从手动到自动:CLAUDE.md → skill → CI/CD |
| 11 | 发布有流程:冻结 → 发布 → 文档 → 部署 |
| 12 | 复盘让经验沉淀 |
动手做
- 运行
/retro,回顾整个 NoteFlow 开发过程 - 运行
/insights,分析你的使用模式 - 写一篇简短的复盘笔记,记录你学到的和想改进的
- 保存到
docs/notes/retro-noteflow.md
本章小结
| 命令 | 做什么 |
|---|---|
/retro |
项目回顾:做得好的、改进的、下次尝试的 |
/insights |
使用分析:命令频率、时间分布、优化建议 |
核心原则: 花十分钟复盘,比多做一小时工作更有价值。知道什么有效、什么无效,才能在下一次做得更好。