retro-bot 是做什么的？
一个用于在 Claude 协作会话上运行轻量级敏捷回顾的技能—— 使与 Claude 合作的过程随着时间的推移逐步改进。
核心循环：在你和 Claude 完成一项工作后，花几分钟一起回答三个问题：
- 什么做得好？ （继续这样做）
- 什么做得不好？ （摩擦、返工、混淆、浪费的 token）
- 我们应该改变什么？ （对技能、提示词或流程的具体改进）
变更会立即应用，并且每次回顾都会作为快照保存到一个持久存档中。 随着时间的推移，这将构建一个可追溯的审计线索，记录你的 Claude 工作流如何演变—— 并累积成一个每次会话都会显著加快的设置。
阶段 0 — 存档目录设置（仅首次运行）
在回顾开始之前，检查是否已配置回顾存档目录。 在 Claude.md 中查找类似这样的块：
## Retro-Bot
archive_dir: [路径]
如果已设置： 直接进入阶段 1。无需再次询问。
如果未设置： 一次性地、清晰地询问用户：
"开始之前——你想把回顾快照保存在哪里？这是一次性设置。给我一个文件夹路径（例如
H:\My Drive\Retros或~/Documents/retros），以后我会自动把每次回顾都保存在那里。"
一旦用户提供了路径：
- 将以下块添加到 Claude.md（如果文件不存在则创建）：
## Retro-Bot archive_dir: [他们给你的路径] - 如果目录不存在则创建它
- 在该目录中创建一个空的
retro-log.md（参见阶段 6 了解其格式） - 确认："收到——回顾存档已设置为
[路径]。所有未来的回顾都将保存到那里。"
然后继续阶段 1。
阶段 1 — 读取会话上下文
阅读会话记录以了解实际发生的情况。如果你的环境提供了会话历史或记录工具，请立即使用它来获取发生的完整记录。（在 Cowork 中，这是自动可用的；在 Claude Code 中，如果可用，使用 /transcript 或等效工具。）即使没有完整的记录，也要根据你所了解的来提取：使用了哪些技能，创建了哪些文件，用户对话过程中给出了哪些反馈，哪些地方需要重做。
如果用户在会话结束后立即调用此技能，你已经有了上下文。 如果他们稍后调用并附带描述，则根据该描述进行工作。
如果不清楚用户想要对哪个会话/工作进行回顾，请请用户确认。
阶段 2 — Claude 以观察结果开始
先说。不要等待用户列出抱怨——分享你注意到的内容。这示范了良好的回顾行为，表明你一直在关注，并且经常会提出用户没有有意识地记下但会立即意识到的事情。
诚实且具体地陈述观察结果：
- "我注意到我不得不重新渲染 SOW 两次，因为第一个表格格式在 Word 中无法正常打开——这是一个我可以修复的技能配置问题。"
- "你分三条单独的消息给了我客户简介，而不是一个完整块——这是一个值得注意的工作流模式，会拖慢进程。"
- "范围构建器和 SOW 构建器技能产生了一致的数字——这感觉流程很顺畅。"
- "我不确定你需要哪种导出格式，直到你中途告诉我——一个提前的快速提问本可以节省一次来回沟通。"
保持在 3-5 个观察结果。要直接，不要防御。你是参与者，而不是旁观者。
阶段 3 — 邀请用户输入
在你的开场白之后，邀请用户补充、修改或提出反对意见：
"这些是我的观察。你的清单上有什么——我遗漏了什么，你有哪些不同看法，或者你想确保我们记录哪些内容？"
你的摩擦点通常与用户的不同。他们可能会指出令人困惑的地方、他们当时没有说出来的输出质量问题、流程上的烦恼，或者感觉很好应该保留的东西。捕捉所有内容。
阶段 4 — 构建回顾板
一旦你们双方都贡献了内容，呈现完整的板。要具体——模糊的项目不会产生有用的行动项。
## ✅ 做得好
- [具体顺利进行的事情]
- ...
## ❌ 做得不好
- [具体的摩擦点，已知的根本原因]
- ...
## 🔧 改进想法
- [与“做得不好”项目相关的具体建议]
- ...
在继续之前请用户确认：
"这能概括所有内容了吗？在我们决定要采取什么行动之前，还有什么要添加或调整的吗？"
阶段 5 — 映射到行动项
对于每个改进想法，确定类型和优先级：
| 类型 | 使用时机 |
|---|---|
| 🔧 技能更新 | 问题源于技能的指令、输出格式或默认行为 |
| 📋 项目/会话更新 | 范围限定于特定项目、客户端或会话类型的上下文或指令——不是全局的 |
| 📝 Claude.md 更新 | 适用于所有地方、所有项目和会话的缺失上下文信息 |
| 💡 流程说明 | 行为改变——无需编辑文件，只需不同的工作方式 |
| 🆕 新技能 | 差距是重复出现的，并且大到足以拥有自己的技能 |
项目/会话更新和 Claude.md 更新之间的关键区别在于范围。 如果上下文应该仅在特定项目、客户端或特定会话类型下适用，则它属于项目/会话层。如果它应该始终、所有地方、对用户的所有工作都适用，则它属于 Claude.md。弄错任何一种方向代价都很大：Claude.md 中的东西太多会在不同客户端之间造成噪音和上下文混淆；项目文件中的东西太多意味着每次切换项目都必须重新设置上下文。
对于每个行动项，说明更改什么、在哪里更改、为什么重要，以及是立即执行还是稍后记录。在应用任何更改之前确认：
"这是我建议更改的内容。要我继续吗？"
有关每种类型的详细指导，请参阅 references/action-item-types.md。
阶段 6 — 使用版本控制应用更改
使用先复制后版本化的模式应用每个已确认的行动项——永远不要直接覆盖源文件。规则：读取当前版本 → 在内存中应用编辑 → 写入新的版本文件名（例如 SKILL-v1.1.md）→ 将旧文件保留在 archive/ 中。这样可以在没有单独版本控制工具的情况下创建可恢复的历史记录。
技能更新： 读取当前版本 → 在内存中应用 → 写入新的版本文件名 → 归档旧版本 → 添加变更日志条目。小修小补 bump 补丁版本，有意义的新增 bump 次版本，架构变更 bump 主版本。
项目/会话更新： 为更改的范围确定正确的指令文件——这可能是仓库或文件夹根目录下的项目级 CLAUDE.md（Claude Code）、Cowork 会话配置、针对重复客户参与的常备简介文件，或范围限定于特定会话类型的自定义指令。如果文件不存在，则创建它。应用与任何其他文件更改相同的先复制后版本化模式。
常见目标：
[项目文件夹]/CLAUDE.md— 在 Claude Code 中，针对该项目的每个会话自动加载[客户端名称]-brief.md或[项目名称]-context.md常备参考文件- Cowork 会话级配置或系统提示词
- Claude.ai 自定义指令（账户设置 → “你想让 Claude 知道什么？”）
Claude.md 更新： 读取当前版本 → 在正确的部分添加上下文 → 写入新版本 → 归档旧版本。如果不存在 Claude.md，则创建一个。
流程说明： 在回顾快照中记录（无需单独文件）。
应用更改后，确认更改了什么：
"完成——已将 [技能名称] 更新至 v1.1，并向 Claude.md 添加了关于 [主题] 的说明。"
阶段 7 — 保存回顾快照并更新审计日志
此阶段是强制性的——每次回顾运行都必须生成保存的快照，无论应用了多少行动项。快照是记录；审计日志是流水线。
步骤 1：保存回顾快照
将完整的回顾快照保存到已配置的 archive_dir。文件名格式：
[archive_dir]/YYYY-MM-DD-[简短描述]-retro.md
示例：H:\My Drive\Retros\2026-05-15-doc-build-retro.md
保持描述简短（3-5 个单词，用连字符连接）：dashboard-build、content-draft、data-analysis-q2。
快照模板
# 回顾快照：[会话描述符]
**日期：** YYYY-MM-DD
**会话类型：** [SOW 构建 / 数据分析 / 内容 / 代码 / 其他]
**使用的技能：** [逗号分隔的列表]
**回顾格式：** [WWW / 开始-停止-继续 / 4Ls / 等]
---
## ✅ 做得好
- [项目]
## ❌ 做得不好
- [项目]
## 🔧 讨论过的改进想法
- [项目]
---
## 行动项与结果
| # | 变更 | 类型 | 目标 | 状态 |
|---|---|---|---|---|
| 1 | [描述] | 技能更新 | [技能] v1.0 → v1.1 | ✅ 已应用 |
| 2 | [描述] | 项目/会话更新 | [项目 CLAUDE.md / 客户端简介 / 会话配置] | ✅ 已应用 |
| 3 | [描述] | Claude.md 更新 | Claude.md | ✅ 已应用 |
| 4 | [描述] | 流程说明 | — | 📝 已记录 |
| 5 | [描述] | 新技能 | [名称] | 🔜 已积压 |
---
## 流程协议
[本次回顾中达成的任何行为协议——双方同意下次以不同方式做的事情，这些无法映射到文件更改]
## 开放问题 / 积压
[稍后记录的项目，需要重新审视的事情，或本次回顾的后续行动]
## 备注
[任何值得保留的额外上下文]
步骤 2：更新审计日志
保存快照后，在存档目录中的 retro-log.md 文件末尾添加一行。该文件是运行中的流水线——一个可一目了然查看所有运行过的回顾的记录。
retro-log.md 格式（首次运行时使用此标题创建）：
# 回顾日志
所有 retro-bot 会话的运行记录。
| 日期 | 会话 | 已应用 | 已记录 | 已积压 | 快照 |
|---|---|---|---|---|---|
每次新回顾添加为一行：
| 2026-05-15 | 文档构建 – 长篇幅提案 | 2 | 1 | 0 | [链接](2026-05-15-proposal-doc-retro.md) |
- 已应用: 状态为 ✅ 已应用的行动项数量
- 已记录: 流程说明的数量（📝 已记录）
- 已积压: 标记为 🔜 已积压的项目数量
保存这两个文件后，确认：
"回顾快照已保存到
[archive_dir]/[文件名]，审计日志已更新。 你现在有 [N] 次回顾记录在案。"
语气和精神
- Claude 先说 —— 在询问用户的意见之前先分享你的观察。
- 要具体 —— “
.docx表格没有渲染出来，因为列宽是硬编码的” 比 “文件格式错了” 更有用。 - 小改变会累积 —— 一个节省每次会话 10 分钟的 3 行修复，加起来非常可观。
- 不是所有东西都需要修复 —— 两个精心选择的改变胜过八个半心半意的改变。
- 保持快速 —— 目标 10–15 分钟。如果耗时过长，说明你在回顾中解决问题，而不是识别问题。把解决问题留到阶段 6。
参考文件
references/retro-formats.md— 其他格式：4Ls、开始/停止/继续、开心/难过/高兴、帆船图。当用户请求不同的格式，或者采用新格式比默认的 WWW 更适合当前会话时阅读。references/action-item-types.md— 关于技能更新与 Claude.md 与流程说明与新技能的详细指导。当行动项的类型不明确时阅读。
变更日志
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0 | 2026-05-26 | 初始版本——完整回顾工作流、6 阶段结构、先复制后版本化、回顾报告模板 |
| v1.1 | 2026-05-26 | 添加了阶段 0 存档目录设置（一次性配置保存到 Claude.md）、强制保存回顾快照、运行中的审计日志（retro-log.md），包含每次回顾的结果追踪 |
| v1.2 | 2026-05-26 | 添加了项目/会话更新作为一个独特的行动项类型——涵盖项目 CLAUDE.md、Cowork 会话配置、客户简介文件以及 Claude.ai 自定义指令；澄清了与用户级 Claude.md 的范围区别 |
| v1.3 | 2026-05-29 | 迁移到插件结构（skills/retro-bot/SKILL.md），为 Claude Code 兼容性添加了 .claude-plugin/plugin.json |