mcpField
G
groove-work-compound

groove-work-compound

github.com/andreadellacorteAgent 工作流6540 次安装14 周前更新
代码仓库

关于 groove-work-compound

用于复盘当前聊天中工作的 Groove skill,将经验、根因、修复和后续行动记录到项目文件。它还会处理待捕获内容和未解决的错误事件,并可选记录工作流经验。

主要功能

  1. 01复盘整个聊天线程中的工作
  2. 02记录经验与根因分析
  3. 03更新相关项目文件
  4. 04生成标记完成或待办的行动清单
  5. 05处理待捕获内容和未解决事件

适用场景

  1. 01在功能开发或规划会话后记录经验
  2. 02复盘后更新项目规则或任务描述
  3. 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-capture Stop 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