| name | swcc-stats |
| description | Use when the user wants to see a topic's review progress or dashboard. 触发:「看进度」「stats」「复习到哪了」「进度如何」「还剩多少没复习」。 |
| argument-hint | [topic] |
| user-invocable | true |
swcc · stats — 复习进度展示
只读地展示一个专题的复习进度。
开始前先读数据契约:${CLAUDE_PLUGIN_ROOT}/skills/_shared/data-contract.md。本技能只读不写。
参数:$ARGUMENTS —— 可选 topic（默认 config 的 activeTopic）。
核心原则
- 只读，不改任何文件。
- 不编数字。 趋势/统计数据不足时如实留空或省略，绝不臆造。
- 最该复习的排在最前。 薄弱点按
nextReview 升序，让用户一眼看到今天该补什么。
流程
1. 加载数据
- topic 缺省 → 读
$HOME/.study-with-cc/config.json 的 activeTopic（config 不存在或缺 activeTopic 时，按数据契约第九节「兜底」扫 topics/ 自愈，不要直接报错）。
- 该专题不存在 → 提示先
/swcc-plan <topic>，停止。
- 读
progress.json（必要时读 review-sessions/ 做趋势聚合）。
2. 计算
- 按
nodes 的 status 统计:mastered / in_progress / not_started 各占多少、百分比。
weakPoints 按 nextReview 升序排列（最该复习的在前）。- 从
stats 取 streak、totalReviewCount、totalReviewTime。
3. 渲染
📊 <topic> 复习进度
━━━━━━━━━━━━━━━━━━━━
🟢 已掌握：<a> / <total> (<x%>)
🟡 学习中：<b> / <total> (<y%>)
🔴 未开始：<c> / <total> (<z%>)
🔴 薄弱点（<n>）
1. <concept>（节点：<node> 上次：<lastReviewed> 下次：<nextReview>）
2. …
🔥 连续复习：<streak> 天
🔢 总复习次数：<totalReviewCount>
⏱️ 总复习时长：<totalReviewTime> 分钟
掌握度变化趋势（可选）:若 review-sessions/ 有多份记录，可按日期聚合各节点掌握度，画一个简单的 ASCII 趋势条;数据不足时省略此段，不要编造数字。
质量基准
- 比例数字和 progress.json 对得上;薄弱点按 nextReview 正确排序。
- 数据不足的段落如实省略，不臆造趋势。
