dojo-teach
Codojo S3 阶段唯一 skill：正式交互式教学。按 `.codojo/task.md` 学习计划逐个知识点进行教学，每个知识点分理论 + 实践两环节。 两种状态模式（自动路由）： - start : schedule.md 进度 = 0% 或刚从 S2 进来 → 从第一个知识点开始 - resume : schedule.md 进度 > 0% 且 < 100% → 定位到上次断点继续 确认驱动：理论环节等用户回复"理解"才进实践，实践环节等用户回复"完成" 才推进下一知识点。全程实时更新 schedule.md 记录进度百分比。 触发关键词：开始学习、继续学习、S3、教我、teach、下一个知识点、 继续教、学下一个、next、回到教学。 前置条件：`.codojo/open-questions.md`（含 ASSESS_DONE）+ `task.md` + `schedule.md` 三文件均已存在。 若前置不满足，必须提示用户先完成前置阶段（S1 或 S2），不可跳过。 后置产出：持续更新 `.codojo/schedule.md` 直到总进度 = 100%。 注意：本 skill **只做教学**，不做项目改造（那归 dojo-hack · S4）。 S3 完成（100%）后若用户继续说"教我"，应提示 S3 已毕业并询问是否进入 S4。
npx skills add ttguy0707/codojo --skill dojo-teach --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# dojo-teach — S3 正式教学 > 一句话定位：按学习计划交互式教学，理论+实践并行，实时跟踪进度直到 100%。 ## 何时使用 - ✅ S1 + S2 已完成，`task.md` 和 `schedule.md` 已存在 - ✅ 用户说"开始学习"、"继续学习"、"教我"、"下一个" - ✅ 用户中断后重新回来继续学习 - ❌ `open-questions.md` 不存在 → 转 `dojo-assess` - ❌ `task.md` 不存在 → 转 `dojo-plan` - ❌ 用户想直接魔改项目 → 转 `dojo-hack`（需 S3 100% 完成） ## 前置条件 - `<repo-root>/.codojo/open-questions.md` 存在（S1 产出） - `<repo-root>/.codojo/task.md` 存在（S2 产出） - `<repo-root>/.codojo/schedule.md` 存在（S2 产出） 若前置条件不满足，提示用户并转到对应 skill。 ## 确认词定义 以下同义词列表用于理论环节和实践环节的状态机判断： | 环节 | 可接受的确认词 | 语义 | |---|---|---| | 理论 → 进入实践 | "理解"、"懂了"、"明白了"、"OK"、"好的"、"了解"、"get" | 用户确认理解理论 | | 实践 → 进入下一知识点 | "完成"、"做完了"、"搞定"、"done"、"好了" | 用户确认完成实践 | | 继续下一知识点 | "继续"、"下一个"、"next"、"go" | 用户确认继续学习 | | 中断休息 | "休息"、"暂停"、"今天到这"、"先这样"、"停" | 用户选择中断 | **规则**：用户回复的内容如果不在上述确认词列表中（即使看起来像确认），一律视为提问或反馈，进入答疑/辅导流程。 ## 工作流 ### Step 1：读取进度，定位当前位置 读取 `schedule.md`，找到第一个状态为 ⚪（未开始）或 🔄（进行中）的知识点。 - 如果全部为 ✅ → 教学已完成，提示进入 S4 - 如果有 🔄 → 从该知识点的未完成环节继续（理论或实践） - 如果有 ⚪ → 从该知识点的理论环节开始 向用户展示当前位置和总进度： ```markdown --- 📊 **学习进度**: ██████░░░░ 58% (14/24 知识点) 📍 **当前位置**: 模块 3 - Spring Boot 自动配置 ⏭️ **即将开始**: 理论讲解 --- ``` ### Step 2：理论环节 读取 `task.md` 中当前知识点的理论要点和涉及文件，结合项目实际代码进行讲解。 **讲解要求**： - 先说"为什么"（这个概念 / 技术存在的意义，
- 何时使用
- 前置条件
- 确认词定义
- 工作流
- Step 1：读取进度，定位当前位置
- Step 2：理论环节
- Step 3：实践环节
- Step 4：更新进度
- Step 4.5：上下文刷新（每 3 个知识点）
- Step 5：推进或完成
- 中断恢复机制
- 产出
- Gotchas
- 不该做的事
What does the dojo-teach skill do?
Codojo S3 阶段唯一 skill：正式交互式教学。按 `.codojo/task.md` 学习计划逐个知识点进行教学，每个知识点分理论 + 实践两环节。 两种状态模式（自动路由）： - start : schedule.md 进度 = 0% 或刚从 S2 进来 → 从第一个知识点开始 - resume : schedule.md 进度 > 0% 且 < 100% → 定位到上次断点继续 确认驱动：理论环节等用户回复"理解"才进实践，实践环节等用户回复"完成" 才推进下一知识点。全程实时更新 schedule.md 记录进度百分比。 触发关键词：开始学习、继续学习、S3、教我、teach、下一个知识点、 继续教、学下一个、next、回到教学。 前置条件：`.codojo/open-questions.md`（含 ASSESS_DONE）+ `task.md` + `schedule.md` 三文件均已存在。 若前置不满足，必须提示用户先完成前置阶段（S1 或 S2），不可跳过。 后置产出：持续更新 `.codojo/schedule.md` 直到总进度 = 100%。 注意：本 skill **只做教学**，不做项目改造（那归 dojo-hack · S4）。 S3 完成（100%）后若用户继续说"教我"，应提示 S3 已毕业并询问是否进入 S4。
How do I install it?
Run `npx skills add ttguy0707/codojo --skill dojo-teach --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ttguy0707/codojo, a repository with 50 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.