codojo

Codojo 初始化入口（必须最先触发的 skill）。 触发词：dojo init、道场启动、开始学习、启动、dojo start。 职责： 1. 强制读取 _shared/methodology.md，让 AI 完整理解四阶段教学方法论 2. 读取完成后，直接转入 dojo-stage 进行阶段调度 本 skill 只做一件事：让 AI 加载方法论上下文。路由调度统一由 dojo-stage 负责。 适用场景：首次使用、新开 session 恢复上下文。

Codojo S1 阶段唯一 skill：能力评估。全面分析目标项目的技术栈与 理论内容，生成 `.codojo/open-questions.md` 评估用户当前水平。 两种状态模式（自动路由）： - start : open-questions.md 不存在 → 扫描项目 → 生成问题清单 → 逐题交互 - resume : open-questions.md 存在但无 ASSESS_DONE 标记 → 题目框架已有， 跳过项目扫描和题目生成，从第一个未填写答案的问题继续问答 触发关键词：评估水平、S1、能力评估、assess、测试我的水平、我会什么、 看看我的基础、开始评估。 前置条件：由 dojo-stage 路由器确认当前应进入 S1（.codojo/ 中无完成标记）。 后置产出：`.codojo/open-questions.md`（末尾含 `<!-- ASSESS_DONE -->` 标记）。 注意：本 skill **只做能力评估**，不生成学习计划（那归 dojo-plan · S2）。 如果 open-questions.md 已存在且末尾包含 `<!-- ASSESS_DONE -->` 标记， 说明 S1 已完成，应转 dojo-plan（S2），不可重复评估（除非用户明确要求重测）。 如果用户直接说"帮我学习这个项目"，应由 dojo-stage 路由，不可直接进入本 skill。

Codojo S4 阶段唯一 skill：魔改（可选进阶）。S3 教学完成后的实战环节， AI 基于项目分析为用户推荐多个魔改方向（加功能、重构、性能优化等）， 用户可多选或自定义，然后制定 `.codojo/plan.md` 并按计划对项目进行实际改造。 两种状态模式（自动路由）： - init : plan.md 不存在 → 推荐魔改方向 → 用户选择 → 生成 plan.md - resume : plan.md 已存在 → 读取计划 → 从上次断点继续执行 plan.md 随用户需求持续更新，S4 不设边界，直到用户主动说"结束"为止。 触发关键词：魔改、改造项目、加功能、S4、hack、我想改这个项目、 动手改、重构、优化、加个功能、实战。 前置条件：`.codojo/schedule.md` 总进度 = 100%（S3 已完成）。 若前置不满足，必须提示用户先完成 S3 教学，不可跳过。 后置产出：`.codojo/plan.md`（持续更新） + 对项目代码的实际修改。 注意：本 skill 会**实际修改项目代码**，每次代码改动前必须先展示方案并等用户 确认"执行"后才动手，不可自作主张直接改代码。 如果用户未完成 S3 就说"我想改项目"，应由 dojo-stage 拦截并提示先完成教学。

Codojo 学习笔记本（跨阶段）。用户在教学过程中随时说"记到笔记本"、 "记一下"、"这个很重要"时触发。AI 将当前对话中的知识点提炼、整合后 写入 `.codojo/notebook.md`，按项目技术栈自动分章节组织。 核心约束： - 增量追加：不覆盖已有内容，只在合适的章节下追加新知识点 - 智能归类：根据知识点内容自动判断归属章节，已有章节则追加，无匹配则新建 - 去重合并：如果新内容与已有笔记高度重复，合并而非重复追加 - 格式统一：每条笔记带时间戳和来源阶段标记（S1/S2/S3/S4） 触发关键词：记到笔记本、记一下、记笔记、notebook、这个很重要、帮我记住、 mark this、记下来、加到笔记、重点记录。 前置条件：`.codojo/` 目录存在（已进入学习流程）。 后置产出：`.codojo/notebook.md`（持续增量更新）。 注意：本 skill **只做笔记整理**，不中断当前教学流程。记完后应立即回到 用户中断前的教学上下文继续，不需要用户额外操作。 如果 notebook.md 不存在则自动创建并初始化章节结构。

Codojo S2 阶段唯一 skill：学习计划生成。从 S1 产出的 `.codojo/open-questions.md` 读取用户能力画像，结合项目结构分析， 生成个性化学习计划 `task.md` + 进度跟踪表 `schedule.md`。 已掌握的内容跳过或简化，重点放在用户薄弱环节。 状态模式： - generate : task.md 不存在 → 读取评估结果 + 分析项目 → 生成计划 - regenerate : 用户明确要求重新生成计划 → 覆盖已有 task.md + schedule.md 触发关键词：生成学习计划、制定计划、S2、学习路径、plan、规划学习路线、 帮我安排学习顺序、生成 schedule。 前置条件：`.codojo/open-questions.md` 已存在且末尾含 `<!-- ASSESS_DONE -->` 标记。 若前置不满足，必须提示用户先完成 S1（dojo-assess），不可跳过。 后置产出：`.codojo/task.md` + `.codojo/schedule.md`（两文件同时存在即视为 S2 完成）。 强制约定：task.md 的第一个知识点固定为「0.1 项目全景」（分层结构 + 模块职责 + 为什么这样分）， 让用户先建立全局认知再钻细节；schedule.md 首行须与之对应。 注意：本 skill **只产学习计划**，不执行教学（教学归 dojo-teach · S3）。 如果用户直接说"开始学习"但 task.md 已存在，应转 dojo-teach（S3），不在此 skill 停留。

Codojo 知识检测 skill：每个模块学完后自动触发的小测验，验证用户真正理解了所学内容。 由 dojo-teach 在每个模块（非每个知识点）完成后自动调用，也可由用户手动触发。 用户有权跳过任何测验——回复"跳过"、"不用了"即可继续下一模块，不强制。 两种触发模式： - auto : S3 教学中每完成一个模块自动触发（由 dojo-teach 调用） - manual : 用户主动说"考考我"、"测试一下" 触发关键词：考考我、测测我、quiz、测验、检测一下、test me、 我学会了吗、验证一下。 跳过关键词：跳过、跳过测验、不用了、skip、算了、直接继续。 前置条件：至少有一个模块的知识点已完成（schedule.md 中有 ✅ 记录）。 后置产出：无独立文件，测验结果追加到 schedule.md 的学习日志中。 注意：本 skill **只做知识检测**，不做教学（答错时只给简短要点提示， 不展开完整讲解——完整讲解归 dojo-teach）。

Codojo 进度回档工具（跨阶段管理）。用户说"重来"、"重置"、"回到某阶段"时触发。 工作流：读取 `.codojo/` 下所有文件状态 → 整理出当前进度表（含每阶段 完成情况和关键产出物）→ 展示给用户并询问回档目标 → 用户选择回档阶段 → 列出将被删除/重置的文件清单 → 等用户确认 → 执行删除/重置 → 路由到目标阶段。 四种回档模式： - 回到 S1 : 删除所有文件（open-questions.md / task.md / schedule.md / plan.md） - 回到 S2 : 保留 open-questions.md，删除 task.md / schedule.md / plan.md - 回到 S3 : 保留 open-questions.md + task.md，重置 schedule.md 进度为 0%，删除 plan.md - 回到 S4 : 保留 S1-S3 产出，仅删除 plan.md 触发关键词：重来、重置、reset、回到 S1、回到 S2、回到 S3、回到 S4、回档、 清除进度、重新开始、从头来、rollback、我想回退、回退进度。 安全约束：删除文件前必须向用户展示将删除的文件列表，等用户回复"确认"后才执行。 不可静默删除。如果用户说"取消"则不做任何操作。 注意：本 skill **只做文件删除/重置**，不执行任何教学或评估动作。 回档完成后自动调用 dojo-stage 重新路由到目标阶段。 如果 .codojo/ 目录不存在（尚未开始），提示用户"还没有任何进度，无需重置"。

Codojo 唯一入口路由器（所有学习请求必须先经过本 skill）。 自动检测 `<repo-root>/.codojo/` 目录下的文件状态，判断当前处于 S1-S4 哪个阶段，输出状态报告后路由到正确的 skill。 三种触发场景（自动路由）： - 首次进入：.codojo/ 不存在 → 创建目录 + 路由到 dojo-assess（S1） - 中断恢复：用户回来说"继续" → 检测文件状态 → 路由到断点阶段 - 状态查询：用户问"当前进度" → 输出状态表 → 等待用户指令 触发关键词：帮我学习这个项目、帮我学这个项目、学习这个项目、教我这个代码、 帮我入门、我是新手、从零开始、开始学习、开始、继续、继续学习、上次到哪了、 当前进度、我在哪个阶段、我在哪、learn this project、teach me。 注意：本 skill **只做路由判断**，不执行任何教学 / 评估 / 编码动作。 判断完成后必须**询问用户确认**再转入目标 skill，不可静默跳转。 如果用户直接说了具体阶段关键词（如"生成学习计划"），仍应先经过本 skill 做一次状态校验，确保前置条件满足后再转入。

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。