用途
groove-utilities-stats 用于回答「工作流是否正在复利增长／我是否保持了节奏」这一量化问题。它打印一个只读仪表盘，对指定周期内的复合循环健康状况进行量化，不写入任何文件。对于定性的模式与反思，该技能指向 /groove-utilities-memory-retrospective。
主要能力
仪表盘围绕三个板块输出：
复合漏斗（Compound funnel）
- Lessons captured：统计 .groove/memory/learned/*.md（排除 signals.md）中 ## YYYY-MM-DD 格式的日期条目数量，给出总数与周期内数量。
- Graduated：统计同一批文件中的 [graduated YYYY-MM-DD] 标记，给出总数与周期内数量。
- Graduation rate：毕业率 = graduated_total / captured_total 的百分比（若无捕获则为 n/a）。
依从性（Adherence）
- Daily logs：最近 review_days 个工作日（周一至周五，截至今天）中有多少天存在 .groove/memory/daily/YYYY-MM-DD.md 文件。
- Streak：从今天往前连续的、存在每日日志的工作日天数，遇到第一个缺口停止。
- Rollups：当前或上一周存在 .groove/memory/weekly/<ISO-year>-W<ISO-week>.md 则 weekly 为 fresh，否则 stale；monthly 同理，对应 .groove/memory/monthly/YYYY-MM.md。
- Ratings：解析 .groove/memory/learned/signals.md 表格行（| YYYY-MM-DD | N/5 | note |），筛选日期 ≥ since 的行，报告数量与平均值，数量 ≥ 3 时附 ▁▂▄▆█ 迷你走势。
速度（Velocity）
- Commits：统计 git log --oneline --since=<since> 的数量。
- Tasks：依据 tasks.storage 配置的 backend 统计：
- beans：open = beans list --json --no-status completed --no-status scrapped | jq length；closed = --status completed + --status scrapped；此外尽力统计 "Mistakes"/"Promises" 史诗下非终态子项数量作为 open mistakes/promises。
- linear：通过 linear CLI/MCP，将指派 issue 分为 open 与 done。
- github：gh issue list --assignee @me --state all，分为 open 与 closed。
- none：省略任务计数，仅显示 commits。
使用方式
使用 $ARGUMENTS 指定周期：week（默认）、month 或 all。
bash 快速路径：该技能在 scripts/stats.sh 有 bash 脚本，直接运行以获得更快、无模型的执行：
bash .agents/skills/groove-utilities-stats/scripts/stats.sh week
（传入 week、month 或 all 以匹配 $ARGUMENTS。）若脚本退出码为 0，报告其 stdout 并停止——不要继续执行后续步骤。若退出码非零，则继续 Markdown 步骤（退出码 3 表示已打印本地指标，但 linear/github 任务计数仍需按下方计算；退出码 1 表示没有 .groove/）。
模型回退路径（Markdown 步骤）：
- 记忆路径固定为 .groove/memory/。若 .groove/ 不存在，停止并给出安装提示。
- 读取 .groove/index.md frontmatter：tasks.storage（backend；旧键为 tasks.backend）与 memory.review_days（默认 5）。
- 根据 $ARGUMENTS 确定日期范围：week = 最近7天，month = 最近30天，all = 全部。记为 start <since>。
- 计算复合漏斗、依从性与速度（算法见上文「主要能力」）。
- 按下述输出格式打印仪表盘。
输出格式
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.
适用场景
- 查看工作流是否在持续复利增长、是否保持记录节奏。
- 需要量化每日日志覆盖、连续记录天数与汇总文件新鲜度时。
- 需要查看任务开闭情况与提交速度时。
- 作为 /groove-utilities-memory-retrospective（定性反思）的量化补充，两者交叉引用而非重复。
限制
- 只读——从不写入任何文件（不写记忆、不写 AGENTS.md、不写配置）。
- 任何缺失的数据源以一行 n/a/NA 跳过，而非报错；解析表格与日期时采取防御式处理。
- 路径硬编码在 .groove/memory/ 下（不可配置），与 groove 其余部分保持一致。
- 该技能不重复 retrospective 的叙述内容。
- 其他未在资料中说明的功能、收费、平台或效果暂未提供。