chrichuang218/ai-learning-coach / plugins/ai-learning-coach/skills/learning-coach
learning-coach
Verified中文高级私人学习教练。用户说“开始学习 X”“继续/下一课”“学完了”“记录进度/打卡”“我学到哪了/还要多久”,正在通过真实项目、源码、作品、题目或任务学习编程、Agent、写作、语言、考试、研究或职业技能,或对具体概念和材料连续追问时使用。触发后主动读取学习现场、学习记录、进度、用户背景和真实材料,替用户选择最近发展区与入口,一次只给一个动作或问题,并用解释、实践、反馈和迁移证据推进掌握。不要让用户先设计课程、选择材料或填写长问卷;只有方向取舍本身尚未解决且会造成明显浪费时,才交给 focus-coach。
| File | Kind | Size |
|---|---|---|
| COACHING-MODES.md | markdown | 7.0 KB |
| EVIDENCE-FORMAT.md | markdown | 3.7 KB |
| GLOSSARY-FORMAT.md | markdown | 901 B |
| LEARNER-BACKGROUND-FORMAT.md | markdown | 2.0 KB |
| LEARNING-RECORD-FORMAT.md | markdown | 3.3 KB |
| LEARNING-SCIENCE.md | markdown | 5.7 KB |
| LESSONS.md | markdown | 6.3 KB |
| MISSION-FORMAT.md | markdown | 1.3 KB |
| PROGRESS-FORMAT.md | markdown | 9.6 KB |
| PROJECTS.md | markdown | 4.3 KB |
| REFERENCE-FORMAT.md | markdown | 3.5 KB |
| RESOURCES-FORMAT.md | markdown | 3.4 KB |
| RESUME.md | markdown | 1.7 KB |
| SKILL.md | skill md | 20.8 KB |
| STARTER-TRACKS.md | markdown | 3.0 KB |
| TRACKS-FORMAT.md | markdown | 1.3 KB |
| WORKSPACE-FORMAT.md | markdown | 8.3 KB |
| WORKSPACE-LIFECYCLE.md | markdown | 5.0 KB |
| agents/openai.yaml | config | 383 B |
PROGRESS-FORMAT.md
View on GitHub# PROGRESS.md:学习进度与节奏格式
`PROGRESS.md` 是用户可见的学习仪表盘。它回答四个问题:目标能力走到哪里、约定的项目学习范围走到哪里、最近是否持续投入、按当前节奏还需要多久。
## 目录
- [事实与派生](#事实与派生)
- [何时创建](#何时创建)
- [推荐模板](#推荐模板)
- [掌握状态](#掌握状态)
- [进度计算](#进度计算)
- [时间估算协议](#时间估算协议)
- [贡献与连续学习](#贡献与连续学习)
- [更新顺序](#更新顺序)
掌握百分比是派生状态;出勤部分只保存紧凑活动事实:
```text
MISSION.md
-> 目标与完成标准
sources/<project>.md
-> 项目学习范围与完成标准
learning-records/*.md
-> 实际掌握证据与后续教学状态
PROGRESS.md
-> 汇总掌握状态,并保存紧凑的出勤活动
```
出勤不等于掌握。打卡、阅读时长、lesson 数量和文件数量都不能直接提高目标进度或项目进度。
## 事实与派生
只有里程碑表、最近活动、ETA 文字和下一检查点需要手写。快照百分比、“原始加权进度”行和整个学习节奏区都是派生值:
- 有 `learning-lab` MCP 时,用 `set_milestone_state` 改状态(证据不支持会被拒绝),之后由 `sync_progress` 重算;不要手改这些数字。
- 不写手工日历时,学习节奏由最近活动表、学习证据的 `observed_at` 和打卡事件派生,`sync_progress` 会生成节奏区。已有手工日历继续有效;日历标为空白、但当天有证据时会提示 `calendar_missing_activity`。
- 没有工具时按下文手动维护,规则相同。
用户用英文学习时可以使用英文字段,工具同样读取:`Updated:`、`Current mainline:`、`Tracking since:`、`## Snapshot`、`## Goal progress`、`## <name> scope progress`、`## Rhythm`、`## Estimate`、`## Recent activity`、`## Next checkpoint`;状态写作 `Not started 0%`、`Exposed 25%`、`Prompted 50%`、`Independent 75%`、`Transferred 100%`。
## 何时创建
满足以下条件时创建根目录 `PROGRESS.md`:
- 用户明确希望长期感知进度、连续学习、成就或剩余时间。
- 工作区已经有一个可描述的使命,以及至少一项目标能力或项目学习范围。
- 学习会跨会话持续,仪表盘能改善后续选择和动力。
一次短答疑不需要创建。多轨道工作区默认只展开当前高成本主线;冻结轨道可以显示一句状态,但不同时维护多套详细仪表盘。
## 推荐模板
```markdown
# Learning Progress
更新日期:{YYYY-MM-DD}
当前主线:{目标 / track / project}
进度起算日:{YYYY-MM-DD;不根据模糊回忆补签}
## 快照
| 维度 | 进度 | 当前判断 | 剩余估算 |
| --- | --- | --- | --- |
| 目标能力 | `[###########---------] 55%` | {一句话} | {小时区间 / 周区间 / 置信度} |
| 项目学习范围 | `[####----------------] 20%` | {一句话} | {小时区间 / 周区间 / 置信度} |
## 目标能力进度
| 里程碑 | 权重 | 掌握状态 | 当前证据 | 下一次升级证据 |
| --- | ---: | --- | --- | --- |
| {能力} | {20%} | {需提示 50%} | {record 或简短证据} | {可观察行为} |
原始加权进度:{xx.xx%};展示进度:{按 5% 取整后的值}。
## 项目学习范围进度
| 范围里程碑 | 权重 | 掌握状态 | 当前证据 | 下一次升级证据 |
| --- | ---: | --- | --- | --- |
| {模块 / 链路 / 独立任务} | {20%} | {接触 25%} | {record 或简短证据} | {可观察行为} |
原始加权进度:{xx.xx%};展示进度:{按 5% 取整后的值}。
## 时间估算
- 目标达成:{剩余有效学习小时区间},按 {每周有效小时区间} 约 {周区间}。
- 项目范围完成:{剩余有效学习小时区间},按 {每周有效小时区间} 约 {周区间}。
- 置信度:{低 / 中 / 高}。{依据和下一次校准条件。}
- 说明:{范围、节奏、休息日、外部依赖或其他假设。}
## 学习节奏
- 当前连续学习:{N 天}
- 最长连续学习:{N 天}
- 本周有效学习日:{N 天}
- 累计有效学习日:{N 天}
| ISO 周 | 一 | 二 | 三 | 四 | 五 | 六 | 日 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| {2026-W28} | · | · | ░ | · | ▓ | · | █ |
强度:`·` 无有效学习;`░` 回忆、复习或阅读;`▒` 主动解释、预测或源码追踪;`▓` Run、Debug、修改或真实输出;`█` 里程碑、迁移或独立完成。
## 最近成就
- [x] {最近被证据证明的能力或里程碑}
- [x] {最近被纠正的重要误解}
## 最近活动
| 日期 | 强度 | 真实动作 | 关联记录 |
| --- | --- | --- | --- |
| {YYYY-MM-DD} | {`░` / `▒` / `▓` / `█`} | {一句话动作} | {record 链接;仅出勤时写“无”} |
## 下一检查点
- {下一项最接近升级的里程碑与所需证据}
- {何时重新估算 ETA 或进行阶段复盘}
```
## 掌握状态
每个里程碑只能使用以下状态:
| 状态 | 数值 | 证据含义 |
| --- | ---: | --- |
| 未开始 | 0% | 尚未形成可用证据 |
| 接触 | 25% | 看过或在支持下识别过,但不能稳定解释 |
| 需提示 | 50% | 能解释或完成,但仍需要明显提示、模板或共同操作 |
| 独立 | 75% | 能在当前项目或同类任务中独立解释、预测、操作或修改 |
| 迁移验证 | 100% | 能在新位置、新任务或变化后的条件中独立使用并验证结果 |
状态依据最新有效证据更新。不要因为时间过去自动降级;只有复习或新任务暴露真实能力变化时才调整。
## 进度计算
1. 目标能力里程碑的权重合计必须为 `100%`。
2. 项目范围里程碑的权重合计必须为 `100%`。
3. 原始进度按 `sum(权重 x 掌握状态) / 100` 计算。
4. 用户可见进度取最接近的 `5%`,避免制造虚假精度。
5. 只有 `learning-records/` 中的解释、预测、Run、Debug、修改、作品、反馈或迁移证据可以改变掌握状态。
6. 同一证据可以同时推动一个目标能力和一个项目范围里程碑,但不能在同一张表里重复计权。
“学完项目”表示完成 `sources/<project>.md` 约定的学习范围,并通过独立或迁移验收;不表示读完仓库每个文件。目标或范围变化时重新建立基线,并在 `PROGRESS.md` 说明原因,不把范围变化伪装成能力退步。
## 时间估算协议
- 同时给出剩余有效学习小时和按当前节奏换算的周区间。
- 周区间使用 `最少剩余小时 / 每周最多小时` 到 `最多剩余小时 / 每周最少小时` 计算,并做合理取整。
- ETA 必须写出学习范围、每周节奏、外部依赖和置信度;不要只给一个完成日期。
- 不从进度百分比线性反推时间。根据未完成里程碑的难度、独立性要求和已观察节奏估算。
- 少于 3 个有效学习日、没有可靠时长或尚无里程碑移动时,置信度保持低并标记“待校准”。
- 记录了至少 3 个有效学习日且出现一次里程碑升级后,可以按真实节奏重新估算;稳定跨越两个以上学习周后才考虑高置信度。
- `有效学习时间` 只有用户明确提供、工具可靠记录或会话时间可准确判断时才写入;不能猜测精确分钟数。
## 贡献与连续学习
- 出现掌握证据、误区纠正或后续教学状态变化时,先写 learning record,并在其中写贡献等级。
- 只有低强度出勤、没有内容值得进入 learning record 时,直接在 `PROGRESS.md` 的“最近活动”和贡献日历记录,不创建伪证据记录。
- 同一天有多条记录时,日历只显示最高等级,不累加制造活跃度。
- `░` 可以增加出勤日和连续学习天数,但不会自动提高掌握进度。
- `▒`、`▓`、`█` 也只有在证据足以改变某个里程碑状态时才提高进度。
- 只从启用进度功能当天开始记录;不要根据“以前学过很多”批量补满历史日历。
- 空白日只表示没有有效学习记录,不扣分,也不降低已经证明的能力。
- 默认保留最近 12 个 ISO 周;更早记录可以按月汇总,避免文件无限增长。
## 更新顺序
每次产生有效学习活动后:
1. 先判断是否出现掌握证据、误区纠正或教学状态变化;有则创建或更新 `learning-records/`,没有则保持 record 不变。
2. 在“最近活动”写一行当天最高强度和真实动作;有关联 record 时添加链接。
3. 判断新证据是否改变一个目标能力或项目范围里程碑;没有改变就保持百分比不动。
4. 更新当天贡献格、连续学习、本周与累计有效学习日。
5. 重新计算两个加权进度和进度条。
6. 在达到校准条件时更新 ETA;否则保留原区间并说明新证据。
7. 只保留最近 2-5 个成就,并把下一检查点写成一个可观察证据。
`PROGRESS.md` 不能取代 learning record,也不要复制每轮完整学习叙述。它只展示当前状态、节奏和方向,并为没有掌握证据的低强度出勤保存一行紧凑事实。
### 一致性与恢复
更新时间和统计截至日期应明确。README 只链接当前进度,不重复维护下一课日期;ETA 不重复存储会漂移的累计天数。查询旧快照时重新计算“当前”节奏,空白日不补签。更早日历已经按月汇总时,保留历史事实,不用可见窗口覆盖累计值。
展示优先回答“已能独立做什么、哪些仍需提示、下一步验证什么”,百分比作为约定里程碑的汇总详情。读取层可以核对权重、证据链接和帮助冲突,但不代替教练判断学习者是否掌握。恢复操作见 [RESUME.md](RESUME.md)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |