第 12 章:回顾与反思 — 项目复盘

⏱ 预计阅读 9 分钟 更新于 2026/5/19
💡 进群学习加 wx: 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):

  1. 三角色审查 — CEO 视角提出了"localStorage 5MB 限制"的问题,省了后面返工
  2. 设计系统先行 — CSS 变量定义好之后,所有组件风格自然一致
  3. subagent 编码 — 7 个任务 30 分钟完成,对比人工 1-2 天
  4. 测试安全网 — 搜索 bug 修复时,全量测试确认没有回归

可以改进的(Improve):

  1. gstack 学习曲线 — 第一次用不熟悉命令,花了额外时间摸索
  2. /design-shotgun — 生成的方案差异不大,选择困难
  3. 审查粒度 — 有些 review 意见过于严格(Suggestion 级别),浪费了修复时间

下次尝试的(Try):

  1. 创建自定义 skill 封装整个流程
  2. 尝试 /executing-plans 对比速度差异
  3. 引入虚拟滚动解决列表性能问题

12.3 /insights — 使用分析

命令语法

/insights

这个命令分析你的 Claude Code 使用数据,告诉你:

  • 哪些命令用得最多
  • 哪些环节花时间最长
  • 有哪些可以优化的模式

典型 insights 结果

使用统计:

  • 总会话数:23
  • 总消息数:187
  • 最常用命令:/subagent-driven-development(8 次)
  • 花时间最长的环节:设计阶段(40%)
  • commit 数:17

摩擦分析:

  1. 审查修复循环 — 平均每个任务有 1.3 次 review 修复循环
  2. 上下文管理 — 第 7 章后需要 /compact 释放空间
  3. 模型选择 — 简单任务用 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
时间线 一天完成 持续几周到几个月
代码量 几百行 几千到几万行
测试 覆盖核心路径 覆盖所有边界情况

迁移建议:

  1. CLAUDE.md 持续更新 — 真实项目的架构和约定会不断变化
  2. 先小后大 — 先在一个小功能上试 gstack+superpowers,再推广到整个项目
  3. 自定义 skill 是关键 — 为团队创建统一的 skill,确保流程一致
  4. 不要全盘 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 复盘让经验沉淀

动手做

  1. 运行 /retro,回顾整个 NoteFlow 开发过程
  2. 运行 /insights,分析你的使用模式
  3. 写一篇简短的复盘笔记,记录你学到的和想改进的
  4. 保存到 docs/notes/retro-noteflow.md

本章小结

命令 做什么
/retro 项目回顾:做得好的、改进的、下次尝试的
/insights 使用分析:命令频率、时间分布、优化建议

核心原则: 花十分钟复盘,比多做一小时工作更有价值。知道什么有效、什么无效,才能在下一次做得更好。