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

WORKSPACE-LIFECYCLE.md

View on GitHub
# 学习工作区:发现、创建与产物

学习工作区是可选的长期记忆,不是开始学习的前置条件。用户只进行一次短学习、当前对话已经足够或长期状态尚未形成时,不要为了形式创建工作区。目录结构见 [WORKSPACE-FORMAT.md](WORKSPACE-FORMAT.md)。

## 目录

- [发现现有工作区](#发现现有工作区)
- [按需创建工作区](#按需创建工作区)
- [PROGRESS.md](#progressmd)
- [learning-records/](#learning-records)
- [reference/](#reference)
- [lessons/](#lessons)
- [临时实验、assets 与 sources](#临时实验assets-与-sources)

## 发现现有工作区

首次开始或跨会话继续时,优先检查:

- 用户当前所在仓库是否已经包含 `MISSION.md`、`PROGRESS.md`、`LEARNER-BACKGROUND.md`、`learning-records/` 或其他明确学习文件。
- 当前对话、本地规则、历史记录或已登记资料是否指定了长期学习工作区路径。
- 当前代码仓库只是被学习的真实项目,还是同时承担学习记录;不要自动把每个源码仓库改造成 learning workspace。

找到明确工作区后直接使用,不重复询问路径,也不另建第二套记录。

## 按需创建工作区

只有出现以下情况之一时才创建:

- 用户明确要求创建 `learning-lab`、学习工作区或长期学习记录。
- 用户准备跨会话持续学习,并且已经出现值得保存的使命、稳定背景或掌握证据。
- 当前仓库或本地规则已经明确指定工作区,但所需的最小文件尚不存在。

路径已经由用户、当前 workspace 或本地规则明确时,可以直接创建。路径无法安全推断时,只问一个短问题确认放置位置;不要让用户选择目录结构、文件模板或记录体系,也不要把示例中的个人绝对路径写进公共规则。

- 独立工作区先创建有实际内容的 `README.md` 和 `MISSION.md`;已知稳定背景时再创建 `LEARNER-BACKGROUND.md`。
- 使命尚未完全确认时可以记录为临时使命,并标出待验证内容,不要伪装成最终目标。
- `PROGRESS.md` 只在长期目标或项目范围已经足够明确、用户需要感知进度时创建。
- `sources/`、`learning-records/`、`reference/` 和 `lessons/` 只在出现第一份真实内容时创建,不生成空目录树。
- 不主动初始化 Git、不复制大型源码仓库、不默认升级为多轨道结构,除非用户要求或真实需求已经出现。
- 无法创建或用户暂不希望创建时,继续当前学习动作,不能因此停课。
- 用户用英文学习时,使用 PROGRESS-FORMAT.md 中的英文字段名,状态工具同样能读取。

创建完成后只简短说明实际路径和已记录内容,然后立即进入或返回当前学习动作,不输出冗长的工作区使用教程。

## PROGRESS.md

保存用户可见的目标进度、项目学习范围进度、学习节奏和剩余时间估算。掌握状态从使命、项目范围和 learning records 派生;出勤不作为掌握证据。目标进度和项目进度分开计算;ETA 使用区间、假设和置信度。创建或更新时读取 `PROGRESS-FORMAT.md`。

## learning-records/

保存个人化的掌握证据和后续教学状态。只有内容会改变下一次教学判断时才写入:用户通过什么行为证明掌握、暴露并纠正了哪个误区、哪种解释或 Debug 方法有效、下一次从哪里继续。不要写流水账,也不要把“用户说懂了”单独当证据。创建学习记录时按需读取 `LEARNING-RECORD-FORMAT.md`,结构化证据见 `EVIDENCE-FORMAT.md`。

## reference/

保存稳定、去个人化、可复用的知识源:已在真实学习中验证的概念模型、对比和易错点,从临时实验提炼的可复现机制,以及跨多次对话仍有复习价值的问答或检查清单。Markdown 是默认格式;`reference/` 必须在没有 Obsidian、LLM Wiki、Notion 或其他工具时也能独立使用,外部知识库只是可选消费者,派生页面应保留来源。HTML 只在交互演示确实增加理解时作为附件,不成为唯一知识源。格式见 `REFERENCE-FORMAT.md`。

## lessons/

Lesson 是发生在真实项目、对话、Run、Debug 与即时反馈中的实时辅导过程,不是预生成文件。默认不创建 lesson 文件;只有辅导需要跨时间保存现场,或这套真实任务值得复用时,才保存简短 Markdown 教练 brief,记录真实锚点、用户起点、教练判断、预计卡点、掌握证据和实际教学路径。读取 `LESSONS.md`。禁止默认生成 HTML lesson、自包含教程、长篇讲义或重复真实源码的平行教材。

## 临时实验、assets 与 sources

- 临时实验:不进入标准工作区目录;解决后清理,稳定结论进入 `reference/`,个人证据进入 `learning-records/`。
- `assets/`:只放跨材料复用的样式、脚本和展示基础设施,不承载主知识。
- `sources/`:登记真实项目、读本和外部材料入口;优先引用,不复制大型源码仓库。
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