你用AI写了个App,却看不懂自己写的代码——这个Skill把代码库变成互动课程

你用 AI 写了个完整项目,能跑,但让你解释一下代码为什么这么写——哑火了?

这不是你的问题。是工具链的问题。

Codebase to Course 这个 Skill,就是来解决这个落差的。它是 Claude Code 的一个插件,安装之后对项目说一句「把这个代码库变成一门课」,就能得到一份漂亮的 HTML 课件:滚动模块导航、代码对照英文释义、数据流动画、嵌入测验。


它不是文档生成器,是个”逆向教学”工具

传统的文档是给已经懂行的人看的。API 文档假设你知道什么叫 REST,README 假设你知道怎么装依赖。

Codebase to Course 反过来——假设你什么都不懂,但你会用产品。它从产品的实际使用路径出发,一层层往代码层走。每学到一个概念之前,先回答「这玩意儿跟用户有什么关系」。

输出长这样:

  • Module 1:这个 App 到底是干嘛的(产品视角)
  • Module 2:请求是怎么流进来的(从用户操作到代码入口)
  • Module 3:数据存在哪,怎么读/写(数据库层)
  • Module 4:核心业务逻辑(决策点和边界情况)

代码永远是真实的——从你的库里直接摘过来,不会被简化,不会被改写。你可以打开原文件对照着看。


测验不考名词,考解决问题

大多数 AI 生成的「学习内容」里的测验都是:「API 是什么的缩写?」

Codebase to Course 的测验风格完全不同:「用户反馈切换页面后数据还是旧的,你第一时间查哪里?」

这不是背书,是看你会不实用。


给谁用

「Vibe Coder」—— 会用 AI 写代码,但没有 CS 背景的人。 你能 prompt 出一整个 Next.js 应用,但请求为什么返回 500,你完全没概念。

生成一份课件,读一遍,再回头看 AI 写的代码——这时候你才能真正提有用的修改意见,而不是只会说「这里好像不对」。

也适合:
– 团队新人入职,用课件代替口头 walkthrough
– 开源项目维护者,给贡献者一个友好的上手路径
– 技术 founder,向非技术合伙人解释系统在干嘛


安装方法

# 克隆到本地
git clone https://github.com/zarazhangrui/codebase-to-course
# 复制到 Claude Code 的 skills 目录
cp -r codebase-to-course ~/.claude/skills/

然后在任意项目里跟 Claude Code 说:

「把这个代码库变成一门互动课程」

输出的 course.html 零依赖,直接浏览器打开就能用,不需要任何构建步骤。


GitHub 链接: https://github.com/zarazhangrui/codebase-to-course


GitHub: https://github.com/zarazhangrui/codebase-to-course

评论区

0 条评论

登录后可评论。

苏棠 13 阅读