{"_id":"@dieselzhang/repo-mastery","_rev":"5-108ce59a2af77c9107656025eb8c861f","name":"@dieselzhang/repo-mastery","dist-tags":{"latest":"3.2.0"},"versions":{"2.2.0":{"name":"@dieselzhang/repo-mastery","version":"2.2.0","keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"license":"MIT","_id":"@dieselzhang/repo-mastery@2.2.0","maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"homepage":"https://github.com/DieselZhang/repo-mastery#readme","bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"bin":{"repo-mastery":"bin/repo-mastery.js"},"dist":{"shasum":"e1a7d7c19c37aba792526225d2b332a4449fe84d","tarball":"https://registry.npmjs.org/@dieselzhang/repo-mastery/-/repo-mastery-2.2.0.tgz","fileCount":31,"integrity":"sha512-gCnn74JExZcH+HK5BnwBGAGrQBBUuk0RYcqTcK2/Apy/GtV09zHd44SgiDAzyvlZFzeo82FxHKl9692NhfuDbg==","signatures":[{"sig":"MEYCIQDsGbb9kyqSW+pkgA/lrIGAgMA5IpHYDxdNNs4zVCpdXQIhAM03z8cAqH9DEKCvxTJ43CWYwkPVHXdzAzhPnxeSGGA+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":177329},"engines":{"node":">=18"},"gitHead":"4bf7bfc98ebd319a596965555e91c60617a3f473","scripts":{"install:all":"node bin/repo-mastery.js install"},"_npmUser":{"name":"dieselzhang","email":"1076508854@qq.com"},"repository":{"url":"git+https://github.com/DieselZhang/repo-mastery.git","type":"git"},"_npmVersion":"11.11.0","description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","directories":{},"_nodeVersion":"25.8.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/repo-mastery_2.2.0_1786096266654_0.8306231105668314","host":"s3://npm-registry-packages-npm-production"}},"2.2.1":{"name":"@dieselzhang/repo-mastery","version":"2.2.1","keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"license":"MIT","_id":"@dieselzhang/repo-mastery@2.2.1","maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"homepage":"https://github.com/DieselZhang/repo-mastery#readme","bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"bin":{"repo-mastery":"bin/repo-mastery.js"},"dist":{"shasum":"c84c34857bdb7cb1726a2613ffb1531923038179","tarball":"https://registry.npmjs.org/@dieselzhang/repo-mastery/-/repo-mastery-2.2.1.tgz","fileCount":31,"integrity":"sha512-jSZDiWZybv79fk2URfdVI+lWWUGRgSiKtrsDT5+saeDC/Xylnx19xdLwSpObg22YYFdumV9KCx+LYwHk5Tchyg==","signatures":[{"sig":"MEQCIAZx5erI0e35dLF5EFLin888nGw1w6+HVejG4KbmVn8EAiA7TmK0py5dtwCEgN1LzbTy2TxtO5OosVEdVKCf+6bW5g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":177329},"engines":{"node":">=18"},"gitHead":"4bf7bfc98ebd319a596965555e91c60617a3f473","scripts":{"install:all":"node bin/repo-mastery.js install"},"_npmUser":{"name":"dieselzhang","email":"1076508854@qq.com"},"repository":{"url":"git+https://github.com/DieselZhang/repo-mastery.git","type":"git"},"_npmVersion":"11.11.0","description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","directories":{},"_nodeVersion":"25.8.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/repo-mastery_2.2.1_1786096547731_0.9548433061448178","host":"s3://npm-registry-packages-npm-production"}},"2.4.0":{"name":"@dieselzhang/repo-mastery","version":"2.4.0","keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"license":"MIT","_id":"@dieselzhang/repo-mastery@2.4.0","maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"homepage":"https://github.com/DieselZhang/repo-mastery#readme","bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"bin":{"repo-mastery":"bin/repo-mastery.js"},"dist":{"shasum":"e55924e169b1db8a486f7f248b279e1c77c4dff0","tarball":"https://registry.npmjs.org/@dieselzhang/repo-mastery/-/repo-mastery-2.4.0.tgz","fileCount":32,"integrity":"sha512-lq7X3p4hR15c12YPrKeSuwcXIjxlIK4XTC8QbfyTrgZQt5OrvO79A4XxVX+AzLxaeN7mTS/fmR8XFQwYgkGpWA==","signatures":[{"sig":"MEUCIGKZ5pucIABrMe3DbL5EDLWxUR1N6rLzs+iSY+g9NzjaAiEAmvcD3xvts38DIp4Vtz8Xd3VBIcmq1ZyoLCoSeEZtXsM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":191902},"engines":{"node":">=18"},"gitHead":"4b26c5100de2fb223813e4323d5a7ed00d79e9b5","scripts":{"install:all":"node bin/repo-mastery.js install"},"_npmUser":{"name":"dieselzhang","email":"1076508854@qq.com"},"repository":{"url":"git+https://github.com/DieselZhang/repo-mastery.git","type":"git"},"_npmVersion":"11.11.0","description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","directories":{},"_nodeVersion":"25.8.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/repo-mastery_2.4.0_1786284725747_0.5636712919293028","host":"s3://npm-registry-packages-npm-production"}},"2.10.0":{"name":"@dieselzhang/repo-mastery","version":"2.10.0","keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"license":"MIT","_id":"@dieselzhang/repo-mastery@2.10.0","maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"homepage":"https://github.com/DieselZhang/repo-mastery#readme","bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"bin":{"repo-mastery":"bin/repo-mastery.js"},"dist":{"shasum":"10dddf03c0464df5dfbabd0c9d9c06d6a63a6d88","tarball":"https://registry.npmjs.org/@dieselzhang/repo-mastery/-/repo-mastery-2.10.0.tgz","fileCount":35,"integrity":"sha512-7d2mNGZEbJ1+O/gyTSkUZdu3o0I2dB2JNt1G+T4vkaIqvF8+WjEAP8G67Wa2jjppbSRbMYiS6VuIHn1O89D1qA==","signatures":[{"sig":"MEYCIQCrRicxl6rqSxOSAPKoLu6dyx299QGzAsG1ZeH9wDg/7gIhAIswSG2lueOQcCeZNWnVO9sU6OoMzLWDe5xvhaesUFTJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":323699},"engines":{"node":">=18"},"gitHead":"9c814f855c318c6777dc2b16fe55c408a86e3aa5","scripts":{"install:all":"node bin/repo-mastery.js install"},"_npmUser":{"name":"dieselzhang","email":"1076508854@qq.com"},"repository":{"url":"git+https://github.com/DieselZhang/repo-mastery.git","type":"git"},"_npmVersion":"11.11.0","description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","directories":{},"_nodeVersion":"25.8.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/repo-mastery_2.10.0_1786461793830_0.6515010810075674","host":"s3://npm-registry-packages-npm-production"}},"3.2.0":{"name":"@dieselzhang/repo-mastery","version":"3.2.0","description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","bin":{"repo-mastery":"bin/repo-mastery.js"},"scripts":{"install:all":"node bin/repo-mastery.js install"},"engines":{"node":">=18"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/DieselZhang/repo-mastery.git"},"keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"publishConfig":{"access":"public"},"gitHead":"1d09c8d47ebd05ee7dd1b042410975e55c3e8dff","_id":"@dieselzhang/repo-mastery@3.2.0","bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"homepage":"https://github.com/DieselZhang/repo-mastery#readme","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-+O0zl3WFzOJZ36d3wpEk7Ycubi8N6i9B8nN36Awgd2Fgd4NuOt9VoU0gzBPkWBxfMFMxj7Z9Tx/akQBCCtgVyw==","shasum":"ab39fa7272bd4cea601f3a43e8f9d2042bfc3107","tarball":"https://registry.npmjs.org/@dieselzhang/repo-mastery/-/repo-mastery-3.2.0.tgz","fileCount":39,"unpackedSize":441723,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC18N/Z24I+XK7AOoUQkWjsCR4bugGzOrWw7Mt3XNHszgIhANDE7BkWZECrfGUC2Maz/jNno0gtJngy0tBnQ6G1s/D2"}]},"_npmUser":{"name":"dieselzhang","email":"1076508854@qq.com"},"directories":{},"maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/repo-mastery_3.2.0_1786590102995_0.24813954479360656"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T09:51:06.445Z","modified":"2026-08-13T03:01:43.306Z","2.2.0":"2026-08-07T09:51:06.792Z","2.2.1":"2026-08-07T09:55:47.867Z","2.4.0":"2026-08-09T14:12:05.908Z","2.10.0":"2026-08-11T15:23:13.989Z","3.2.0":"2026-08-13T03:01:43.137Z"},"bugs":{"url":"https://github.com/DieselZhang/repo-mastery/issues"},"license":"MIT","homepage":"https://github.com/DieselZhang/repo-mastery#readme","keywords":["claude-code","codex","gemini-cli","skill","learning","mastery","spaced-repetition","open-source","education"],"repository":{"type":"git","url":"git+https://github.com/DieselZhang/repo-mastery.git"},"description":"Turn any open-source repository into a developer-focused mastery course — usage, architecture, key implementations, with deterministic mastery gates and spaced review. Installable as a skill for Claude Code, OpenAI Codex, and Gemini CLI.","maintainers":[{"name":"dieselzhang","email":"1076508854@qq.com"}],"readme":"
\n\n# 📚 Repo-Mastery\n\n**把任意开源仓库变成开发者视角的掌握式课程。**\n\n像学一门真实课程一样，掌握一个项目的 **使用 → 架构 → 关键实现** —— 有经你确认的课程地图、确定性掌握度闸门、间隔重复，以及 Markdown + HTML 双形态的课程产出。\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-skill-0A84FF.svg)](#)\n![Version](https://img.shields.io/badge/version-3.2.0-blue.svg)\n![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)\n\n[English](./README.md) · [文档](./docs/zh-CN/ARCHITECTURE.md) · [贡献指南](./CONTRIBUTING.md)\n\n
\n\n

\n \"Repo-Mastery\n

\n\n---\n\n## 目录\n\n- [这是什么？](#这是什么)\n- [为什么](#为什么)\n- [特性](#特性)\n- [工作原理](#工作原理)\n- [安装](#安装)\n- [使用](#使用)\n- [命令](#命令)\n- [数据模型](#数据模型)\n- [项目结构](#项目结构)\n- [文档](#文档)\n- [贡献](#贡献)\n- [许可](#许可)\n- [致谢](#致谢)\n\n---\n\n## 这是什么？\n\nRepo-Mastery 是一个 **Agent skill**，把任意开源仓库转成结构化的、面向开发者的掌握式课程。给定本地仓库路径或 GitHub URL，它：\n\n1. **客观预扫描**代码库，提出**课程地图**（模块 + 知识点）。\n2. 由**你确认并定制**课程地图 —— 与你的 **Mission**（为什么想掌握这个仓库）对齐。\n3. 驱动**交互式掌握度学习** —— 诊断 → 讲解 → 费曼检验 → 练习 → 错误诊断 → 间隔复习。\n4. **持久化**进度、笔记与**学习记录**，支持跨会话续学。\n5. 合成**完整课程文档**（Markdown + HTML，可分享）。\n\n它是 `docs-to-course`（教终端用户怎么用工具）的深度进阶版：Repo-Mastery 教开发者一个项目是**怎么被构建的**。\n\n## 为什么\n\n作为开发者，读完一个开源项目的代码，往往不等于\"掌握\"。Repo-Mastery 用一套可判定的学习机制弥合这个差距：\n\n- 每个知识点都有**确定性掌握度闸门** —— 不是 LLM 的主观印象。\n- **间隔重复**对抗遗忘；**学习记录**捕捉你的理解如何演化。\n- 笔记与进度**跨会话持久化**，随时精确续学。\n\n## 特性\n\n- 🗺️ **基于证据的课程地图** —— 每个模块/知识点都指向真实文件、目录与调用链。\n- 🧭 **Mission 驱动** —— 扎根于\"为什么想学\"，而不是泛泛覆盖。\n- ⚖️ **双轨掌握度闸门** —— 定量（近因加权准确率 ≥ 0.9）用于使用/操作；定性（费曼复述）用于概念/架构。\n- ⏳ **间隔重复** —— 每种类型独立间隔序列，错题提升优先级。\n- 🔧 **动手验证** —— 命令经你批准后运行；procedure 知识点必须有真实证据才算掌握。\n- 📝 **持久笔记 + ADR 式学习记录** —— 自动沉淀 + 手动追加；记录追踪理解演化并支持 supersession。\n- 🌍 **自适应提取** —— 中小仓库直接读；大型仓库用轻量 Python 索引（`code-map.json`）。\n- 📦 **双形态产出** —— 全量 Markdown 课程（`COVERAGE.md`）+ 可分享的交互式 HTML 课程。\n- 🌐 **双语** —— 讲解语言跟随你的输入；代码与标识符保持原文。\n- 🧰 **多 CLI 支持** —— 同一 skill 原生运行于 **Claude Code、OpenAI Codex、Gemini CLI** 及遵循 AGENTS.md 的工具。确定性闸门是真代码（`scripts/learning_engine.py`），所有工具共用，掌握度数学永不错位。\n\n## 工作原理\n\n```text\nPhase 0 复杂度评估 → 决定提取方式（纯读 / Python 索引）\nPhase 1 客观预扫描 → 课程地图候选\nPhase 2 Mission + 地图确认 → 你批准/定制（强制步骤）\nPhase 3 交互式掌握度学习（诊断 → 讲解 → 费曼 → 练习 → 错误诊断 → 间隔复习）\nPhase 4 合成 COVERAGE.md + 可选可分享 HTML 课程\n```\n\n核心设计公理：**智能在出口，进阶在闸门** —— 模型决定教什么，但能否进阶永远是确定性引擎判定。\n\n## 安装\n\n本仓库**本身就是**这个 skill，遵循开放的 **Agent Skills 标准**（agentskills.io）——同一份 `SKILL.md` 原生运行于 Claude Code、OpenAI Codex、Gemini CLI。**五种安装方式，任选其一：**\n\n### 1. npm —— 一条命令\n\n```bash\nnpx @dieselzhang/repo-mastery install # 任意工具、任意位置\n# 或全局安装 CLI：\nnpm i -g @dieselzhang/repo-mastery && repo-mastery install\n# 选项：repo-mastery install --only codex / --skip gemini / --dry-run\n```\n\n### 2. curl —— 一行，无需 npm\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/DieselZhang/repo-mastery/main/scripts/install.sh | bash\n```\n\n安装到 Claude Code + Codex + Gemini。管道后加 `--only codex`（等）可选。\n\n### 3. Claude Code —— 原生插件安装\n\n```bash\nclaude plugin marketplace add DieselZhang/repo-mastery\nclaude plugin install repo-mastery@repo-mastery\n```\n\n（会话内等价：`/plugin marketplace add …` 然后 `/plugin install …`。）\n\n### 4. 对话安装 —— 让 CLI 自己装\n\n| 工具 | 对它说 |\n|---|---|\n| **Claude Code** | \"把 github:DieselZhang/repo-mastery 的 repo-mastery skill 安装到 ~/.claude/skills\"（Claude 会 clone + 放置），或走上面的 `/plugin` 路线 |\n| **OpenAI Codex** | 在 Codex 里用内置安装器：`$skill-installer install https://github.com/DieselZhang/repo-mastery` |\n| **Gemini CLI** | \"把 github:DieselZhang/repo-mastery 的 repo-mastery skill clone 到你的 skills 目录\" |\n\n### 5. 手动 —— clone\n\n```bash\ngit clone https://github.com/DieselZhang/repo-mastery ~/.claude/skills/repo-mastery\ncd repo-mastery && ./scripts/install.sh # 从 checkout 安装到其他工具\n```\n\n### 各工具查找位置\n\n| 工具 | skill 目录 | 入口 |\n|---|---|---|\n| **Claude Code** | `~/.claude/skills/` | `SKILL.md` —— `/repo-mastery start <仓库>` |\n| **OpenAI Codex** | `~/.codex/skills/`（或 `~/.agents/skills/`） | `SKILL.md` + `agents/openai.yaml` |\n| **Gemini CLI** | 其 skills 目录（`GEMINI_SKILLS_DIR` 可覆盖） | `activate_skill` / `GEMINI.md` |\n| **opencode / Cursor**（AGENTS.md 工具） | 项目目录 | `cp AGENTS.md <项目>/AGENTS.md` |\n\n> **Codex 注意**：Codex 只读自己的目录，不读 `~/.claude/`。请安装到 `~/.codex/skills/` 才会被发现。安装后重启 CLI。\n>\n> **插件注意**：以插件方式安装会把 skill 缓存到 `~/.claude/plugins/cache/`，调用为带命名空间的形式（`/repo-mastery:repo-mastery`）。\n\n**环境要求**\n\n- 目标仓库：本地路径，或可访问的 `github:owner/repo`（skill 自动 `git clone --depth 1`）。\n- Python 3.8+ —— 确定性引擎（`scripts/learning_engine.py`）与大型仓库索引（`scripts/index_repo.py`）需要，均纯标准库。\n\n## 使用\n\n```bash\n/repo-mastery start <本地路径 | github:owner/repo> [--language zh|en] [--fresh]\n```\n\n示例 —— 从 GitHub URL 学一个项目：\n\n```bash\n/repo-mastery start github:DieselZhang/repo-mastery\n```\n\nskill 会带你走完四个阶段。讲解语言默认跟随你的输入；传 `--language zh` / `--language en` 可强制指定。\n\n## 命令\n\n| 命令 | 作用 |\n|---|---|\n| `/repo-mastery preview <路径\\|url>` | 探路 — 只出宏观简报（这是什么 / 架构全景 / 功能差异 / 关键亮点 / 建议深学候选）；零副作用、不建 `.learning/`；说「深学」转入 start |\n| `/repo-mastery start <路径\\|url>` | 主流程：价值简报 → 地图 → 确认 → 概览 → 学习（默认每模块教材式章节）；`--fresh` 重启已有课程 |\n| `/repo-mastery continue` | 续学 — 智能路由：无 `.learning/`？引导 start；未完成？Session Preamble → 到期复习（标记）→ 新内容；已完成？报告。裸 `/repo-mastery` 即此命令 |\n| `/repo-mastery review` | 仅间隔复习 — 刷到期项，绝不打开新内容 |\n| `/repo-mastery note [\"<文本>\"]` | 整理自上次 note 以来的讨论进当前模块笔记（分类归纳）；可选 text 逐字追加 |\n| `/repo-mastery status` | 刷新单页状态看板 `MASTERY.md`（进度 / 掌握度 / 复习待办 / 下一步） |\n\n## 数据模型\n\n```text\n<目标仓库>/.learning/ ← 随仓库走；自动 gitignore\n ├── MISSION.md 学习使命（为什么想掌握它）\n ├── course-map.json 已确认的课程地图\n ├── progress.json 掌握度 / 间隔复习 / 卡点\n ├── MASTERY.md 单页状态看板（进度 / 掌握度 / 复习待办 / 下一步）\n ├── records/NNNN-slug.md ADR 式学习记录（理解演化）\n ├── notes/.md 结构化笔记（自动 + 手动 /note 区间归纳）\n ├── notes/.boundary.json /note 区间边界（module_id + 时间戳）\n ├── chapters/.md 教材式章节材料（默认路径；每模块一份）\n ├── briefs/.md 模块简报（大型仓库省 token）\n ├── export/ HTML 课程输出（index.html + modules/0N-slug.html；见 Phase 4）\n └── code-map.json 大型仓库索引（可选）\n~/.repo-mastery/ 全局轻量记忆\n ├── profile.md 跨仓库偏好 / 水平 / 卡点\n └── index.json 学过的仓库 + 续学状态\n```\n\n## 项目结构\n\n```text\nrepo-mastery/\n├── SKILL.md skill 定义（英文；Agent Skills 标准）\n├── README.md 本文件（英文）\n├── README.zh-CN.md 中文镜像\n├── ADOPTION.md 归属声明：DeepTutor / docs-to-course / teach\n├── CONTRIBUTING.md 贡献指南\n├── AGENTS.md 遵循 AGENTS.md 工具（Codex/opencode/Cursor）的协议\n├── GEMINI.md Gemini CLI 的协议\n├── LICENSE MIT\n├── package.json npm 打包（`repo-mastery install` 一条命令安装）\n├── .claude-plugin/ Claude Code 插件 marketplace + plugin 清单\n│ ├── marketplace.json\n│ └── plugin.json\n├── agents/\n│ └── openai.yaml Codex / Agent-Skills UI 元数据\n├── bin/\n│ └── repo-mastery.js npm 一条命令安装器\n├── scripts/\n│ ├── learning_engine.py 确定性闸门（掌握度/排期/记录/下一步/校验/初始化）\n│ ├── index_repo.py 大型仓库代码索引（纯标准库）\n│ └── install.sh 一键安装到 Claude Code + Codex + Gemini（也支持 curl 管道）\n├── references/ skill 内部文件（按阶段读取）\n│ ├── curriculum-design.md 从源码设计课程地图\n│ ├── mastery-policy.md 掌握度 / 闸门 / 间隔复习 / 错误诊断\n│ ├── session-flow.md 交互式学习协议（Mission + ZPD）\n│ ├── quiz-design.md 测验设计（测应用不测记忆）\n│ ├── module-brief-template.md 模块简报（预提取源码片段）\n│ ├── note-template.md 笔记格式\n│ ├── learning-records-template.md ADR 式学习记录\n│ ├── gotchas.md 失败点清单\n│ ├── index-script-spec.md 索引脚本说明\n│ └── html-shell/ HTML 课程外壳（复制自 docs-to-course）\n└── docs/\n ├── ARCHITECTURE.md 设计与架构（英文）\n ├── USAGE.md 使用指南（英文）\n └── zh-CN/ 中文镜像\n```\n\n## 文档\n\n- [架构设计](./docs/zh-CN/ARCHITECTURE.md) —— 设计、掌握度引擎、各阶段、数据模型。\n- [使用指南](./docs/zh-CN/USAGE.md) —— 详细命令参考与学习流程。\n- [变更日志](./CHANGELOG.md) —— 各版本显著改动（v1.0.0 → v3.2.0）。\n- [采纳与归属](./ADOPTION.md) —— 本 skill 从 DeepTutor、docs-to-course、teach skill 吸收了哪些设计。\n\n## 贡献\n\n欢迎贡献。参见 [CONTRIBUTING.md](./CONTRIBUTING.md)。\n\n## 许可\n\n[MIT](./LICENSE) © 2026 DieselZhang。\n\n## 致谢\n\n- **掌握度引擎** 移植自 [DeepTutor](https://github.com/HKUDS/DeepTutor)（HKUDS，MIT）—— 确定性闸门、间隔重复、错误诊断、`explore_context` 预扫描。\n- **课程设计与 HTML 外壳** 吸收自 `docs-to-course`（codebase-to-course）。\n- **学习机制**（Mission、ZPD、学习记录、fluency vs storage）吸收自 [mattpocock-skills](https://github.com/mattpocock) 的 `teach` skill。\n\n逐条归属说明：[ADOPTION.md](./ADOPTION.md)。\n","readmeFilename":"README.zh-CN.md"}