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

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 的派生页面必须保留来源,避免形成两份独立维护的真相。
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: 472kUpdated 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