SuperAPI AI 工具集

groove-work-compound

通用与其它

查看项目

更新于 10-14 17:53

技能介绍

用途

groove-work-compound 用于在一次评审或工作收尾之后「复利(compound)」本次会话的产出:记录经验教训、分析根因、更新相关项目文件,并生成一份可执行的行动清单。技能的作用范围限定在「本次对话」——即用户调用 compound 的同一个聊天线程内的全部消息。经验与复利动作来源于该线程中任意位置完成或决定的工作。

在范围内的内容包括:同一聊天中更早完成的工作(例如 /ppp-weekly-report、/groove-work-plan 等其他技能运行、文件或 bean 编辑、决策、评审或计划讨论);用户或线程作为工作流一部分引用的任何 bean 或工作项(例如本次 compound 阶段所属的 epic 或任务)。

不在范围内的内容包括:每日记忆、每周总结或其他文档(例如「对一整天做 compound」),除非用户明确要求。

如果在 compound 运行时上下文中看不到其他工作(例如该轮只显示了 compound 请求),技能会询问要对哪个会话或工作做 compound,而不是草率地得出「没有讨论任何工作」的结论。

主要能力

  • 记录经验教训并做根因分析:不只记录哪里出了错,也分析为什么。
  • 更新相关项目文件:规则文件、模板、文档、任务正文。
  • 生成复合动作检查清单,每项标注 done 或 pending,并说明每项动作的重要性(为什么重要,而不只是做什么)。
  • 若检测到用户挫败模式(反复修复、困惑、返工),会专门捕捉该模式及其触发条件。
  • 允许「No new lessons」作为显式可接受的结果——如果确实没有新经验,会明确记录这一点,而不是直接跳过。
  • 处理未决错误事件:在生成检查清单前,通过 /groove-utilities-memory-mistakes --list 检查未决的 mistake 事件;若有,按 log → fix → audit → resolve 循环逐个处理,并在检查清单中加入对应条目;若没有则静默跳过。
  • 识别跨项目的工作流经验:如涉及 AI 工作流、智能体行为、工具使用或工程流程(而非特定代码库或产品)的经验,会建议将其加入 .groove/memory/learned/<topic>.md,并等待用户确认、选择其他主题或跳过。
  • 经验沉淀后可选地提供「毕业」建议:如果该经验足够稳定,可运行 /groove-utilities-memory-graduate <topic> 将其永久提升到 AGENTS.md(仅在刚确认经验时建议一次)。
  • 扫描被推迟的事项:识别「我们稍后再回来」「以后再做」「下次」「TODO」「暂时跳过」「今天不改」等表述,列出后询问是否记录为 promises;确认的条目通过 /groove-utilities-memory-promises <text> 记录。
  • 可选会话评分:询问用户给本次会话打分(1–5),说明 compound 循环对其帮助程度;若提供评分,则追加写入 .groove/memory/learned/signals.md 的表格中(格式 | YYYY-MM-DD | <rating>/5 | <一行会话主题上下文> |);若用户跳过则不再提及。

使用方式

从 .groove/index.md 读取 tasks.backend;记忆路径固定为 .groove/memory/。

若存在 .groove/.cache/pending-capture.md(由 session-capture Stop 钩子暂存),优先读取它,并将其中的 commits / working-changes 作为经验教训和 git 上下文的真值来源,以免遗忘或压缩过的会话丢失;在 compound 阶段记录完成后删除该文件。

输出写入现有的项目文件,除非必要不创建新文件。即使看起来「没什么可捕捉」,也始终运行,并把这一点明确记录下来。

如果 tasks.backend != none,则通过 /groove-utilities-task-create 在后端创建阶段任务,标题具有描述性,以便区分一天内的多次 compound,格式为:YYYY-MM-DD, Compound — <brief topic>(topic 取自刚收尾的工作,例如 release、feature 或会话摘要)。任务标题中不对阶段编号。

若捕获了工作流经验且在 .groove/index.md 中设置了 groovebook:,则在检查清单后加一行建议:"Learning captured → .groove/memory/learned/<topic>.md. Publish to groovebook? Run /groove-groovebook-publish.";若未设置 groovebook: 则静默跳过。

适用场景

适用于一次开发、评审或计划工作收尾之后,需要把本次会话中的经验、修正、决策沉淀为可复用的项目规则或文档时。适合作为工作流的收尾阶段(例如与 plan、weekly-report 等技能配合使用)。

限制

作用范围严格限定在同一对话线程内;每日记忆、每周总结等需用户明确要求才纳入。未提供关于该技能的具体安装命令、平台支持、收费或价格的资料。