Skip to content

chrichuang218/ai-learning-coach / plugins/ai-learning-coach/skills/learning-coach

learning-coach

Verified

中文高级私人学习教练。用户说“开始学习 X”“继续/下一课”“学完了”“记录进度/打卡”“我学到哪了/还要多久”,正在通过真实项目、源码、作品、题目或任务学习编程、Agent、写作、语言、考试、研究或职业技能,或对具体概念和材料连续追问时使用。触发后主动读取学习现场、学习记录、进度、用户背景和真实材料,替用户选择最近发展区与入口,一次只给一个动作或问题,并用解释、实践、反馈和迁移证据推进掌握。不要让用户先设计课程、选择材料或填写长问卷;只有方向取舍本身尚未解决且会造成明显浪费时,才交给 focus-coach。

FileKindSize
COACHING-MODES.mdmarkdown7.0 KB
EVIDENCE-FORMAT.mdmarkdown3.7 KB
GLOSSARY-FORMAT.mdmarkdown901 B
LEARNER-BACKGROUND-FORMAT.mdmarkdown2.0 KB
LEARNING-RECORD-FORMAT.mdmarkdown3.3 KB
LEARNING-SCIENCE.mdmarkdown5.7 KB
LESSONS.mdmarkdown6.3 KB
MISSION-FORMAT.mdmarkdown1.3 KB
PROGRESS-FORMAT.mdmarkdown9.6 KB
PROJECTS.mdmarkdown4.3 KB
REFERENCE-FORMAT.mdmarkdown3.5 KB
RESOURCES-FORMAT.mdmarkdown3.4 KB
RESUME.mdmarkdown1.7 KB
SKILL.mdskill md20.8 KB
STARTER-TRACKS.mdmarkdown3.0 KB
TRACKS-FORMAT.mdmarkdown1.3 KB
WORKSPACE-FORMAT.mdmarkdown8.3 KB
WORKSPACE-LIFECYCLE.mdmarkdown5.0 KB
agents/openai.yamlconfig383 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)。
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall