mcpField
R
retro

retro

github.com/boshu2Agent 工作流450837 次安装1 天前更新
代码仓库

关于 retro

retro 是用于快速记录单条经验的 Agent 技能，适合将暂时不需要完整复盘、但值得保留的发现写入 `.agents/learnings/`。记录会作为候选经验，后续仍需经过成熟度晋升流程。

主要功能

  1. 01快速捕获单条经验
  2. 02根据内容生成文件名
  3. 03记录日期与来源信息
  4. 04将条目保存到指定目录

适用场景

  1. 01保存工作中的小型发现
  2. 02避免有用经验只留在交接中

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/boshu2/agentops --skill retro

安装后在 Claude Code 中输入/retro确认已加载。

附带文件references/retro.featurescripts/validate.sh

详细介绍

Retro 技能

你必须执行此工作流。不要只描述它。

快速记录一条经验，加入知识飞轮。若要进行包含待办事项处理、激活和退役的全面复盘，请使用 /post-mortem。

循环位置

这是操作循环第 7 步最轻量的记录方式。将单条观察快速记录到 .agents/learnings/。当某条见解太小，不值得进行完整的 /post-mortem，但又很可能有用、不应留在交接内容中时，请使用此方式。记录之后仍适用晋升棘轮——复盘条目是候选经验，尚未成为模式或规则。

快速模式

收到 /retro --quick "insight text" 或 /retro "insight text" 时：

  1. 根据内容生成 slug：取最有意义的开头词语，全部小写，用连字符连接，最多 50 个字符。
  2. 使用 timeout_run 1 bd current 2>/dev/null || echo "" 解析当前激活的 bead。
  3. 直接写入 .agents/learnings/YYYY-MM-DD-quick-<slug>.md：
---
type: learning
source: retro-quick
source_bead: <active bead id when available>
source_phase: validate
date: YYYY-MM-DD
maturity: provisional
utility: 0.5
---

# Learning: <Short Title>

**Category**: <auto-classify: debugging|architecture|process|testing|security>
**Confidence**: medium

## What We Learned

<user's insight text>

## Source

Quick capture via `/retro --quick`

如果没有激活的 bead，请有意省略 source_bead，并仍设置 source_phase: validate。

  1. 确认：
Learned: <one-line summary>
Saved to: .agents/learnings/YYYY-MM-DD-quick-<slug>.md

For comprehensive knowledge extraction, use `/post-mortem`.

完成。 确认后立即返回。

示例

用户说： /retro --quick "macOS cp alias prompts on overwrite — use /bin/cp to bypass"

执行过程：

  1. Agent 生成 slug：macos-cp-alias-overwrite
  2. Agent 使用 timeout_run 1 bd current 2>/dev/null || echo "" 解析当前激活的 bead
  3. Agent 将经验写入 .agents/learnings/2026-03-03-quick-macos-cp-alias-overwrite.md，并包含如下溯源字段：
---
type: learning
source: retro-quick
source_bead: bd-123
source_phase: validate
date: 2026-03-03
maturity: provisional
utility: 0.5
---
  1. Agent 确认：Learned: macOS cp alias prompts — use /bin/cp

故障排除

问题原因解决方案
经验过于笼统记录流于表面请具体说明：“auth tokens expire after 1h”，而不是“learned about auth”
经验重复同一见解被记录了两次写入前用 grep 检查已有经验
需要完整复盘快速记录不够使用 /post-mortem 进行全面提取和处理

参考文档

  • references/retro.feature — 可执行规范：将单条观察记录到 .agents/learnings/，作为棘轮下的候选项，是第 7 步最轻量的操作方式（soc-qk4b）

评论

支持 Markdown