mcpField
G
groove-utilities-stats

groove-utilities-stats

github.com/andreadellacorte生产力6264 次安装14 周前更新
代码仓库

关于 groove-utilities-stats

groove-utilities-stats 是只读技能，可按指定时段汇总工作流状态，涵盖经验记录与晋级、日志执行情况，以及可用数据源中的任务和提交。

主要功能

  1. 01按周、月或全部时段报告
  2. 02经验记录与晋级指标
  3. 03每日日志覆盖率和连续记录
  4. 04汇总更新状态与评分
  5. 05任务和提交活动统计

适用场景

  1. 01检查工作流习惯是否稳定
  2. 02查看经验记录与晋级趋势
  3. 03检查日志覆盖率和汇总新鲜度
  4. 04汇总任务与提交进度

安装

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

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

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

附带文件scripts/stats.sh

详细介绍

groove-utilities-stats

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

Bash 快速路径

此技能提供了一个 Bash 脚本 scripts/stats.sh。直接运行即可更快地执行，无需模型参与：

bash .agents/skills/groove-utilities-stats/scripts/stats.sh week

（传入 week、month 或 all，以匹配 $ARGUMENTS。）如果脚本以 0 退出，请报告其标准输出并停止——不要继续执行以下步骤。如果脚本以非零状态退出，则继续执行 Markdown 步骤（退出码 3 表示脚本已输出本地指标，但仍需在下方计算 linear/github 任务数量；退出码 1 表示没有 .groove/）。

结果

在对话中打印只读仪表板，量化该时间范围内复利循环的健康状况：复利漏斗（已记录与已晋升的经验）、执行情况（每日日志覆盖率、连续记录天数、汇总新鲜度、评分）和速度（任务打开/关闭数、提交数）。不会写入任何文件。这可以回答“工作流是否在持续积累成果／我是否保持了节奏”——如需了解定性模式，请参阅 /groove-utilities-memory-retrospective。

验收标准

  • 显示复利漏斗：已记录的经验（总数 + 时间范围内数量）、已晋升的经验（总数 + 时间范围内数量）、晋升率
  • 显示执行情况：最近 memory.review_days 个工作日的每日日志覆盖率、当前连续记录天数、周/月汇总新鲜度、评分数量 + 平均分
  • 显示速度：任务打开/关闭数量（如果已配置任务后端）以及该时间范围内的提交数
  • 输出仅显示在对话中；不写入任何内容
  • 对于缺失的数据源，使用合理的“n/a”/“NA”占位符，而不是报错

步骤

（模型回退方案——上述 Bash 快速路径会以确定性的方式完成这些操作。请复现相同的输出格式。）

  1. 内存路径始终为 .groove/memory/。如果 .groove/ 不存在，则停止并提示安装。

  2. 读取 .groove/index.md 的 frontmatter：tasks.storage（后端；旧版键为 tasks.backend）和 memory.review_days（默认值为 5）。

  3. 根据 $ARGUMENTS 确定日期范围：week = 最近 7 天，month = 最近 30 天，all = 全部。将起始日期称为 <since>。

  4. 复利漏斗：

    • 已记录：统计 .groove/memory/learned/*.md 中日期条目 ## YYYY-MM-DD 的数量（排除 signals.md）——包括总数和日期 ≥ <since> 的数量。
    • 已晋升：统计这些文件中 [graduated YYYY-MM-DD] 标记的数量——包括总数和日期 ≥ <since> 的数量。
    • 晋升率 = graduated_total / captured_total 的百分比（如果没有已记录的经验，则为 n/a）。

  5. 执行情况：

    • 每日日志覆盖率：最近 review_days 个工作日（周一至周五，截至今天）中，有多少天存在 .groove/memory/daily/YYYY-MM-DD.md。
    • 连续记录天数：从今天往前数，最近连续有每日日志的工作日天数；遇到第一个缺漏时停止。
    • 汇总新鲜度：如果当前周或前一周存在 .groove/memory/weekly/<ISO-year>-W<ISO-week>.md，则 weekly 为 fresh，否则为 stale；monthly 同理，检查 .groove/memory/monthly/YYYY-MM.md。
    • 评分：解析 .groove/memory/learned/signals.md 表格中的行（| YYYY-MM-DD | N/5 | note |），筛选日期 ≥ <since> 的行；报告数量和平均分（若数量 ≥ 3，则显示 ▁▂▄▆█ 迷你图）。

  6. 速度：

    • 提交：统计 git log --oneline --since=<since> 的数量。
    • 按 tasks.storage 处理任务：
      • beans：打开 = beans list --json --no-status completed --no-status scrapped | jq length；已关闭 = --status completed + --status scrapped；尽力统计“错误”和“承诺”史诗下的非终结子项数量，作为打开的错误/承诺数。
      • linear：通过 Linear CLI/MCP 获取已分配的问题，并按打开与已完成分组。
      • github：通过 gh issue list --assignee @me --state all 获取问题，并按打开与已关闭分组。
      • none：省略任务数量（仅显示提交数）。

  7. 按照下方的输出格式打印仪表板。

输出格式

## Groove Stats — <period> (<start> to <today>)

### 🔁 Compound funnel
Lessons captured: <N> (<n> this <period>)   Graduated: <G> (<g> this <period>)
Graduation rate: <pct>

### 📿 Adherence
Daily logs: <x>/<review_days> business days   Streak: <s> days
Rollups: weekly <fresh|stale>, monthly <fresh|stale>
Ratings: <c> in period | avg <a>/5  <sparkline>

### 🚀 Velocity
Tasks: <open> open / <closed> closed   Commits: <k> in period
Open: <m> mistakes, <p> promises

_For qualitative patterns and learnings, run `/groove-utilities-memory-retrospective`._

约束

  • 仅限读取——绝不写入任何文件（包括 memory、AGENTS.md 和 config）。
  • 对缺失的数据源，以单行 n/a/NA 跳过，而不是报错；谨慎解析表格和日期。
  • 路径硬编码在 .groove/memory/ 下（不可配置），与 groove 的其他部分保持一致。
  • 此技能补充了 /groove-utilities-memory-retrospective（定性反思）——不要重复其中的叙述；请交叉链接。

评论

支持 Markdown