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 |
EVIDENCE-FORMAT.md
View on GitHub# 可读取的学习证据
学习记录需要由状态工具读取、恢复、复习调度或导出时使用。普通对话和原有 Markdown 记录保持可用;只在真实证据出现后添加元数据,不批量猜测历史值。有 `learning-lab` MCP 时用 `record_evidence` 写入,它会校验字段和 ID 唯一性。
## 一个动作,一份帮助程度
同一记录可包含多个 `learning-evidence` JSON 块,每块对应一个已观察的动作。用户亲自运行教练提供的测试,动作应写“运行目标测试”,帮助程度通常为 guided;只有独立提出输入、观察点和断言并验证,才可能支持独立测试设计。
```learning-evidence
{
"schema_version": 1,
"id": "cache-2026-09-06-run-1",
"observed_at": "2026-09-06",
"milestone_id": "缓存失效",
"action": "运行教练提供的目标测试,并比较缓存重置前后的输出",
"assistance_level": "guided",
"result": "目标测试通过;独立设计反向测试仍待验证",
"source_ref": {
"commit": "bdb7e858ff9be8fbed82d0488e13a63b9b0e3288",
"path": "src/skills.ts",
"symbol": "resetSkillCache"
},
"review_reason": "断言由教练提供,尚未证明独立测试设计",
"next_action": "在修改已有 Skill 内容的相邻场景中预测并验证缓存行为",
"review_after": "2026-09-09"
}
```
上面是格式示例,不是已发生的用户行为。写入时用真实日期、唯一 ID、实际观察和源码 commit。`milestone_id` 对应 PROGRESS 表中里程碑名称;尚未约定里程碑时使用具体能力名,后续保持一致。
| assistance_level | 含义 |
| --- | --- |
| demonstrated | 教练演示,用户尚未自己完成 |
| guided | 有提示、模板或共同操作 |
| independent | 无逐步提示完成这一个动作 |
| transferred | 在相邻新任务中独立使用并验证 |
这些取值描述帮助,不自动映射为掌握百分比。失败同样可以记录真实观察;不能因为元数据完整或 result 写着通过就升级能力。
## 来源类型
`source_ref.kind` 说明证据锚点,非技术学习同样可以写结构化证据:
| kind | 必填字段 | 适用 |
| --- | --- | --- |
| code(默认,有 `commit` 时可省略 kind) | `path`(仓库相对)、`symbol`、`commit`(完整 40 位) | 源码学习 |
| url | `url`(http/https) | 公开文章、题目、作品链接 |
| document | `title`,可选 `locator` | 本地文稿、讲义、书的章节 |
| task | `description` | 口语模拟、现实任务等没有文件的动作 |
代码仓库位置继续放在 sources。恢复时核对当前源码,再定位行号;历史 commit 与当前 HEAD 不同并不自动否定历史证据。
## 复习调度
`review_after`(YYYY-MM-DD,不早于 `observed_at`)表示这条边界最早何时复验。日期已到、且之后没有同一 `milestone_id` 的新证据时,这一项进入到期复习,恢复学习时优先处理。
- 提示下完成或刚纠正的误区:通常 1-3 天后复验;独立完成:约 1 周;迁移验证后一般不再安排。
- 复验得到的新证据(成功或失败)都写成新块,原有块不改;新证据自动结束旧的到期项。
- 只为确实需要保留的能力安排复习,不为凑间隔机械出题。
`review_reason` 保存需要复验的边界,`next_action` 保存一个可观察动作;最近状态仍以 PROGRESS 的下一检查点为入口,二者冲突时先查日期和实际证据。复验失败应写清观察与调整依据,不因空白学习日自动降级。
元数据属于 record 正文的一部分,派生索引可以重建,不建立第二套可独立改写的掌握数据。缺少元数据的旧记录按正文判断,不把 unknown 帮助程度默认为 independent。
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: 472k | 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 |