mcpField
G
groove-utilities-memory-retrospective

groove-utilities-memory-retrospective

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

关于 groove-utilities-memory-retrospective

面向 Groove 用户的只读回顾技能，汇总指定时段的记忆、任务事件、评分、经验和 Git 活动，结果仅显示在对话中。

主要功能

  1. 01按周、月或全部时段回顾
  2. 02会话评分趋势与火花线
  3. 03已解决及未解决事件摘要
  4. 04按主题归纳经验
  5. 05以 Git 提交数估算工作量
  6. 06只读并仅输出到对话

适用场景

  1. 01回顾过去一周或一个月的工作
  2. 02发现重复错误和工作流趋势

安装

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

$npx skills add https://github.com/andreadellacorte/groove --skill groove-utilities-memory-retrospective

安装后在 Claude Code 中输入/groove-utilities-memory-retrospective确认已加载。

详细介绍

groove-utilities-memory-retrospective

使用 $ARGUMENTS 指定时间范围：week（默认）、month 或 all。

结果

在对话中输出一份阶段回顾：会话评分趋势、反复出现的错误模式、记录的主要经验，以及简短的工作流健康状况摘要。不写入任何文件。

验收标准

  • 显示会话评分趋势（如果 learned/signals.md 中有数据）
  • 总结错误模式（来自任务后端中已解决的事件）
  • 按主题列出主要经验（来自 learned/*.md 中带日期的条目）
  • 工作流健康状况摘要：用一句话说明整体趋势
  • 所有输出仅写入对话

步骤

  1. 记忆路径始终为 .groove/memory/

  2. 根据 $ARGUMENTS 确定日期范围：

    • week：最近 7 天（今天 - 7）
    • month：最近 30 天
    • all：所有可用数据
    • 若未提供参数，默认使用：week

  3. 会话评分 — 如果 .groove/memory/learned/signals.md 存在，则读取：

    • 解析符合日期范围的表格行：| YYYY-MM-DD | N/5 | context |
    • 计算：数量、平均评分、趋势（数据充足时比较最近 3 次与最早 3 次）
    • 如果没有数据：注明“尚未记录会话评分”

  4. 错误 — 查询任务后端中“Groove Memory”→“Mistakes”下已解决的事件：

    • beans list --parent <mistakes-epic-id> -t bug -s completed 查询已解决事件；-s in-progress 查询未解决事件
    • 按标题关键词分组，以识别反复出现的模式
    • 统计已解决与未解决事件总数
    • 如果没有任务后端或没有数据：注明“尚未记录事件”

  5. 经验 — 遍历 .groove/memory/learned/*.md（排除 signals.md）：

    • 对每个文件进行读取，并收集日期范围内带日期的条目（## YYYY-MM-DD 标题）
    • 按主题（文件名主干）分组
    • 统计每个主题的条目数；展示每个主题中最新的一条项目作为示例
    • 如果没有文件：注明“尚未记录经验”

  6. Git 活动 — 运行 git log --oneline --since="<start-date>"，统计该时间范围内的提交数，作为工作量的参考

  7. 按以下格式在对话中输出阶段回顾：

## Groove Retrospective — <period> (<start-date> to <today>)

### Session Ratings
<count> sessions rated | avg: <N>/5 | trend: <up/down/flat or n/a>
<sparkline of ratings if ≥3 data points, e.g. ▂▄█▆▇>

### Mistakes
<N> incidents resolved | <N> open
Top patterns:
- <root cause pattern> (N occurrences)
- ...
(No recurring patterns) if all unique

### Learnings
<N total entries across <M> topics>
- patterns (<N> entries): <most recent bullet>
- anti-patterns (<N> entries): <most recent bullet>
- ...

### Workflow Health
<git commits in period> commits | <1-sentence summary of overall trend>
e.g. "Stable week — ratings above 4, one incident (resolved), 3 new patterns captured."

生成迷你趋势图

使用方块字符绘制简单的评分迷你趋势图：

  • 1/5 → ▁、2/5 → ▂、3/5 → ▄、4/5 → ▆、5/5 → █
  • 仅在该时间范围内有 ≥ 3 个评分时显示

限制

  • 只读——不要写入任何文件
  • 如果数据源文件不存在，则跳过对应部分，并用一行说明
  • 稳妥地解析表格行：跳过格式错误的行，不要报错
  • 日期筛选：匹配日期在范围内的 YYYY-MM-DD 行；跳过日期无效的行
  • 输出仅写入对话——绝不写入 AGENTS.md 或记忆文件

评论

支持 Markdown