关于 groove-work-compound
用于复盘当前聊天中工作的 Groove skill,将经验、根因、修复和后续行动记录到项目文件。它还会处理待捕获内容和未解决的错误事件,并可选记录工作流经验。
主要功能
- 01复盘整个聊天线程中的工作
- 02记录经验与根因分析
- 03更新相关项目文件
- 04生成标记完成或待办的行动清单
- 05处理待捕获内容和未解决事件
适用场景
- 01在功能开发或规划会话后记录经验
- 02复盘后更新项目规则或任务描述
- 03整理会话中尚未解决的后续行动
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ andreadellacorte/ groove --skill groove-work-compound安装后在 Claude Code 中输入/groove-work-compound确认已加载。
详细介绍
groove-work-compound
范围
“本次对话”指完整的聊天线程(用户调用 compound 的同一聊天中的所有消息)。经验教训和 compound 操作来自该线程中任何位置完成或决定的工作。
范围内:
- 在同一聊天中更早完成的工作:其他技能运行(例如 /ppp-weekly-report、/groove-work-plan)、文件或 bean 编辑、决策、评审或规划讨论。
- 用户或线程将其作为工作流一部分提及的任何 bean 或工作项(例如 compound 阶段所属的 epic 或任务)。利用这些内容为经验教训和操作提供依据。
除非用户提出要求,否则不在范围内: 每日记忆、每周总结或其他文档(例如“对整天的内容进行 compound”)。
如果运行 compound 时上下文中看不到其他工作(例如当前轮次只显示 compound 请求):询问要对哪个会话或工作进行 compound(例如:“我只看到 compound 请求。你希望我对哪个会话进行 compound?例如上面的 PPP 运行,还是其他内容?”),而不是得出“没有讨论过工作”的结论。
结果
记录经验教训、根本原因和修复方案。更新相关项目文件(规则、模板、文档、任务正文)。生成 compound 操作清单,并标明已完成或待处理状态。
验收标准
- 记录经验教训并进行根本原因分析(不仅说明哪里出了问题,还要解释原因)
- 更新相关项目文件:规则文件、模板、文档、任务正文
- 生成清单,并为每项操作标明已完成或待处理
- 如果发现用户挫败情绪模式,应明确记录
- “没有新经验教训”是可接受的明确结果——应记录,而不是跳过
约束
- 从
.groove/index.md读取tasks.backend;记忆路径始终为.groove/memory/ - 待捕获内容:如果
.groove/.cache/pending-capture.md存在(由session-captureStop hook 暂存),先读取,并将其中的提交/工作区更改用作经验教训和 Git 上下文的事实来源,避免遗忘或压缩的会话丢失。记录复合阶段后,删除.groove/.cache/pending-capture.md。 - 生成复合操作清单前,通过
/groove-utilities-memory-mistakes --list检查是否存在未关闭的错误事件:- 如果存在未关闭的事件:继续之前,按照
/groove-utilities-memory-mistakes中的记录 → 修复 → 审计 → 解决流程逐一处理 - 在复合操作清单中添加:“mistakes: N incident(s) resolved → learned/”(已完成/待处理)
- 如果没有未关闭的事件:静默跳过
- 如果存在未关闭的事件:继续之前,按照
- 将输出写入项目中已有的文件——除非必要,否则不要创建新文件
- 即使看起来“没有什么可捕获”,也始终运行——明确记录这一点
- 复合操作清单必须说明每项操作的重要性,而不只是描述要做什么
- 如果用户反复修正、感到困惑或返工:记录该模式及其触发因素
- 如果
tasks.backend != none,通过/groove-utilities-task-create在后端创建阶段任务,并使用描述性标题,以便区分同一天的多个复合任务:YYYY-MM-DD, Compound — <brief topic>(主题取自刚刚结束的工作,例如发布、功能或会话总结)。任务标题中不要为阶段编号。 - 生成复合操作清单后,识别任何关于 AI 工作流、Agent 行为、工具使用或工程流程的经验教训——而非针对代码库或产品的内容
- 如果发现此类经验教训:
- 提议:“检测到工作流经验——要添加到 .groove/memory/learned/.md 吗?”
- 根据内容建议主题名称(例如
patterns、tools、anti-patterns、hooks) - 等待用户确认、选择其他主题或跳过
- 如果用户确认:在文件中
## <YYYY-MM-DD>标题下以项目符号追加该经验;如果文件不存在,则创建文件并添加# <Topic>标题;如果日期标题不存在,则创建该标题 - 在复合操作清单中添加:“workflow learning → .groove/memory/learned/.md”(已完成/待处理)
- 如果没有工作流经验教训,则完全跳过此步骤——不提示,不打扰
- 如果工作流经验已记录到本地,且
.groove/index.md中设置了groovebook::在清单后添加一行建议:“Learning captured →.groove/memory/learned/<topic>.md. Publish to groovebook? Run/groove-groovebook-publish.” 如果没有groovebook::静默跳过。 - 工作流经验记录后,询问是否要升级: “这条经验是否足够稳定,适用于未来的每个会话?运行
/groove-utilities-memory-graduate <topic>,将其永久提升到 AGENTS.md。”——仅在用户刚刚确认经验时建议,不要在每次复合运行时都建议。 - 工作流经验步骤后,扫描对话中是否有待处理事项——例如“之后再回来处理”“稍后做”“下次”“TODO”“暂时跳过”“今天不修”。如果有:列出这些事项并询问“要把其中哪些记录为承诺?(输入编号,或直接回车跳过)”——对每项已确认内容,运行
/groove-utilities-memory-promises <text>。如果没有,则静默跳过。 - 工作流经验步骤后,询问是否愿意为本次会话评分:
- 询问:“为本次会话评分(1–5):复合流程对你的帮助有多大?(直接回车跳过)”
- 如果用户提供评分:将其追加到
.groove/memory/learned/signals.md的表格中;如果文件不存在,则创建文件并添加标题和表格标题行 - 格式:
| YYYY-MM-DD | <rating>/5 | <one-line context from the session topic> | - 如果用户跳过:之后不要再提及
评论
支持 Markdown