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 |
REFERENCE-FORMAT.md
View on GitHub# Reference:稳定知识源格式
## 目录
- [定位](#定位)
- [什么时候创建](#什么时候创建)
- [Promotion 检查](#promotion-检查)
- [推荐模板](#推荐模板)
- [写作规则](#写作规则)
## 定位
`reference/*.md` 保存已经在真实学习中验证过、去个人化、可长期复用的稳定知识。
它既是本地可直接阅读的知识库,也是可选外部知识系统的 raw/source。用户没有 Obsidian、LLM Wiki、Notion 或其他工具时,reference 仍必须完整可用。
## 什么时候创建
适合创建:
- 一个概念经过对话、Run、Debug 或真实任务验证,心智模型已经稳定。
- 同一误区反复出现,值得形成长期纠错卡。
- 一个最小实验未来仍有复现价值。
- 多次 lesson 都需要引用同一知识单元。
不适合创建:
- 用户刚第一次听到概念。
- 只是一次路径、环境或截图差异。
- 结论仍不确定或只来自单次偶发现象。
- 只是聊天记录、课程流水账或个人情绪。
## Promotion 检查
每次创建或更新 learning record 后执行一次检查。以下信号触发候选判断,不直接等于必须创建:
- 同一边界清楚的主题出现在至少两条记录中。
- 同一误区重复出现,值得形成长期纠错卡。
- 一个实验、Debug 方法或机制以后仍值得复现。
- 多个教学现场需要引用同一知识单元。
- 单条记录已经包含充分的解释、操作和迁移证据。
只有候选同时满足以下门槛才沉淀:结论已被真实行为验证,可以去个人化,未来具有复习或复用价值,能够形成连贯知识单元,并且不会复制已有 reference。记录条数只是检查信号,不是知识成熟度。
处理优先级:
1. 主题已存在时更新原 reference,并补充新证据或边界。
2. 主题稳定且边界独立时创建一篇新 reference。
3. 结论仍需验证时,在 learning record 标记候选主题和缺少的证据。
4. 内容只影响个人教学状态时,在 learning record 标记无需沉淀。
reference 在“来源与可追踪性”中链接支撑它的 learning records;对应 records 链接已沉淀的 reference。不要要求两类文件数量一一对应。
## 推荐模板
````markdown
# {稳定知识主题}
状态:稳定 | 待复验
来源:{真实项目、官方资料或实验}
## 要解决的问题
{未来复习时,用户想快速回答什么?}
## 一句话心智模型
> {...}
## 最小可复现例子
```{language}
...
```
预期输出或行为:
```text
...
```
## 机制解释
{用数据流、控制流、状态或时间线解释。}
## 真实项目映射
- `{path}`:`{symbol}` — {为什么这里体现该机制}
## 易错点
- 错误理解:{...}
正确理解:{...}
## 已有背景对照
{例如 Java 对照;只在确实帮助理解时使用。}
## 复习问题
1. {...}
## 来源与可追踪性
- {...}
````
## 写作规则
- Markdown 是唯一默认主格式。
- 优先保存概念模型、可复现实验、预期输出、真实源码映射和易错点。
- 代码片段只保留理解机制所需的最小范围。
- 个人路径、临时截图和一次性环境差异不进入稳定正文。
- 真实项目映射使用项目标识加仓库相对路径;设备绝对路径只放在 `sources/<project>.md`,不作为稳定知识的一部分。
- HTML 只有在交互演示确实增加理解时作为 Markdown 链接附件。
- 外部 Wiki 的派生页面必须保留来源,避免形成两份独立维护的真相。
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 |