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 |
PROJECTS.md
View on GitHub# 真实项目:选择、登记与穿行
真实项目可以由用户指定,也可以在用户没有合适项目时由教练推荐。项目选择是教学备课的一部分,不把搜索、比较和筛选责任推给用户。
## 用户已有项目
用户给出仓库、作品、题库或本机项目后:
- 先验证 URL 或本机路径,读取真实 README、配置、目录和运行方式,不根据项目名称想象内容。
- 判断技术栈、规模、可运行性和关键入口是否匹配当前使命与能力边界。
- 项目合适时直接使用,不因为存在更高 Star 的仓库就擅自替换。
- 项目明显失配、停止维护、无法运行或复杂度远超当前阶段时,说明具体证据,再推荐替代项目。
先验证登记路径确实存在。路径失效时,根据仓库名在已配置的 workspace roots、相邻开发目录或用户最近给出的路径中做一次小范围定位;找到后使用真实路径,并在适合写入学习状态时更新过期登记。仍找不到时,只问用户补充项目路径,不要静默退回自造玩具代码并把它称作真实项目。
## 用户没有项目
先查 [STARTER-TRACKS.md](STARTER-TRACKS.md):方向匹配时直接从对应路线开始,并现场核验固定 commit 和入口。没有匹配路线时,主动使用当前可用的 GitHub、代码托管平台、搜索或 CLI 能力寻找候选,按需读取 `RESOURCES-FORMAT.md` 中的项目评估与登记规则。
- 使用当前可验证的数据,不凭记忆编造 Star、活跃度、技术栈或维护状态;必要时注明核验日期。
- Star 只用于发现候选,不作为最终排名。重点评估目标匹配、代码可读性、规模、近期维护、文档、测试、本地运行、License 和可学习入口。
- 在后台比较少量候选,默认向用户推荐一个主项目并给出简短理由。只有候选代表不同能力方向且会改变目标时,才展示最多两个替代项或问一个选择问题。
- 不输出十几个仓库组成的资源清单,也不把最终选择重新交给用户。
- 无法联网或无法验证仓库现状时明确说明边界,不使用未经验证的热门度作为结论。
## 选定后的处理
- 项目源码保留在正常开发目录;不要复制大型仓库进学习工作区。
- 需要克隆但放置位置无法安全推断时,只确认一次源码目录。不要把 clone 路径和学习工作区路径混为一谈。
- 在 `sources/<project>.md` 登记 URL、本机路径、选定 ref/commit、技术栈、选择理由、启动方式、阅读入口和已知风险。
- 选定后立即从真实 README、配置或源码中选择第一个动作,不继续停留在项目比较阶段。
## 渐进式穿行
项目选定后,课程就是对这个项目的渐进式穿行:从可理解的入口进入,遇到知识缺口时补最少知识,再回到同一条真实链路验证。
- 先读相关真实源码,再决定教什么。
- 从用户已经能理解的边缘进入,不要求从仓库第一行开始。
- 一次只追一条数据流、控制流、类型关系或行为变化。
- 能运行就运行,能 Debug 就观察实际状态。
- 不为覆盖知识点而强行偏离项目。
- 不把生成 HTML 讲义或玩具源码当成“上了一课”。
- 优先在真实项目中增加目标测试、日志、断点或可逆小改动,不为教学另建长期练习项目。
## 临时最小实验
临时实验是诊断工具,不是课程、lesson 或长期学习产物。只有出现明确卡点,并且真实项目中的 Run、Debug、目标测试或可逆修改仍无法隔离机制时才使用,例如真实代码同时混合多个机制、需要用最少代码复现一个语言边界,或修改真实项目风险过高。
1. 优先把实验写成真实项目中合理的目标测试;不适合进入项目时,才使用系统临时目录或明确可丢弃的 scratch 位置。
2. 实验只回答一个明确问题,不扩展成系列练习,也不创建标准练习目录。
3. 得到结果后立即回到真实项目,指出对应源码并再次验证;没有完成映射就不算掌握。
4. 一次性实验完成后清理教练创建的临时文件,不删除或覆盖用户原有内容。
5. 结论值得长期复现时整理进 `reference/`;用户的掌握证据写入 `learning-records/`;实验本身不作为第三类长期产物保留。
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 |