/review-learning

学习进度评估

系统化评估 $ARGUMENTS 学习项的进度，对比目标与实际进展，提供可操作的改进建议。

核心原则： 评估必须将实际进度与计划目标进行对比，而不仅仅是总结已完成的内容。

触发条件

• "Review my progress"
• "How am I doing with $ARGUMENTS?"
• "评估我的学习"
• "检查进度"
• "我进度怎么样？"

快速参考

评估维度	检查内容	数据来源
时间线	计划 vs 实际日期	README.md 路线图, progress.md 日期
里程碑	已完成 vs 应完成	README.md 清单, progress.md 日志
时间投入	实际时长 vs 预期	progress.md 时间追踪
学习模式	频率、专注度、薄弱点	progress.md 日志条目
资源使用	已参考 vs 已使用	resources.md, 笔记内容
闪卡	已创建数量、掌握程度	flashcards/*.md
间隔重复	复习完成率、逾期项	reviews/spaced-repetition.md
阻塞项	缺失的前置条件	README.md 里程碑依赖

实施步骤

步骤 1: 读取核心文件（必须）

# 读取以下文件
$ARGUMENTS/README.md              # 目标、里程碑、路线图
$ARGUMENTS/progress.md             # 时间追踪、完成状态
$ARGUMENTS/notes/*.md              # 学习证据、模式
$ARGUMENTS/reviews/spaced-repetition.md  # 间隔重复状态
$ARGUMENTS/flashcards/*.md         # 闪卡掌握数据

步骤 2: 时间线评估

计算：

• 当前阶段的预期完成日期（从 README.md）
• 开始至今的天数
• 预期每周投入时长 vs 实际
• 节奏判断："按计划"、"超前"、或"落后"

示例：

Novice 阶段：预期 1 周
开始日期：2025-02-02
今天：2025-02-09
预期总时长：5-7 小时（每天 1 小时）
实际：0.5 小时
状态：落后（剩余天数需要每天 6.5 小时）

步骤 3: 里程碑评估

检查当前阶段的每个里程碑：

• ✅ 标记已完成的清单项
• ❌ 标记未完成的项
• 🚫 识别阻塞项（后续步骤的前置条件）

步骤 4: 模式识别

分析 progress.md 日志中的模式：

模式	关注点	指标
频率	会话间隔天数	是否一致？有中断？
时长	每次会话分钟数	太短？太长？
专注	理论 vs 实践	有代码/项目吗？
阻塞	重复出现的问题	同一问题多次出现？
动力	进度随时间变化	加速？停滞？

步骤 5: 生成建议

按影响程度排序：

1. 🔴 关键 - 阻塞所有进度（如：环境未搭建）
2. 🟡 重要 - 显著拖慢进度（如：缺少基础知识）
3. 🟢 建议 - 优化学习效率（如：增加练习）

输出格式：

## 行动计划（按优先级）

### 关键（今天完成）
1. [具体任务]
   - 操作：[具体命令或步骤]
   - 验证：[如何确认完成]

### 重要（本周内）
2. [具体任务]
   - 所需时间：X 小时
   - 资源：[相关链接]

### 建议（持续改进）
3. [具体任务]
   - 当前：[现状]
   - 推荐：[改进方案]
   - 原因：[为什么]

步骤 6: 更新 progress.md

追加评估记录：

## 学习评估

### YYYY-MM-DD - 进度评估
**评估者**: Claude (review-learning)
**时间线**: [按计划/超前/落后]（实际 X 小时 / 预期 Y 小时）
**里程碑**: X/Y 个 Novice 任务完成
**关键发现**: [主要问题]
**行动**: [下一步]
**下次评估**: YYYY-MM-DD

常见错误

错误	为什么不对	修正方法
只总结不评估	无法帮助用户改进	必须与目标进行对比
忽略时间线	用户无法调整节奏	展示预期 vs 实际
不查 README.md 里程碑	遗漏完成标准	始终评估清单项
跳过模式分析	忽略系统性问题	分析频率、时长、专注度
不更新 progress.md	评估结果丢失	将评估追加到 progress.md
给出泛泛建议	不针对具体差距	将建议与缺失里程碑关联