Codebase to Course：把代码库变成互动课程
把任意代码库一键转成自包含的单页 HTML 互动课程，帮助零技术背景的 AI 编程用户看懂代码底层原理。
技能主要在本地生成 HTML 文件，权限需求低；克隆外部仓库到 /tmp 有一定外部输入但无破坏性默认行为。扣分：克隆外部代码前无用户确认与安全提示，无回滚说明，对外部仓库内容的处理边界未披露，许可信息不明。
流程描述自洽、阶段划分清晰（分析→课程设计→构建→审查），关键路径有明确步骤。扣分：build.sh、styles.css、main.js 等关键引用文件未在本次审阅材料中出现，无法静态验证其存在与正确性；无测试、异常输入处理和失败反馈说明。
目标受众（vibe coder）定义极为清晰，触发语句明确，简单/复杂代码库的分路径适用边界有说明。扣分：对非典型代码库（极大型单体、非英文代码库）的边界未说明；唯一外部依赖为 Google Fonts CDN，对中国大陆网络可达性存在风险，未披露。
文档分层良好（SKILL.md + references 按阶段渐进披露），有明确的设计规范和禁则。扣分：README 称输出为'single HTML file'而 SKILL.md 明确为目录结构，两者矛盾；无版本号、变更日志、许可信息和维护责任说明。
核心任务（代码库→交互课程）路径完整，输出格式明确、声称开箱即用，边际价值明确。扣分：静态审阅无法验证产出质量，README 截图无法核实，真实生成效果与'beautiful'宣称的差距未知。
README 含演示截图链接，属作者自证材料；关键依赖文件未提供，无 CI/测试证据，无法独立复现关键路径。
- SKILL.md 与 README 对输出形态的描述相互矛盾（目录+build.sh vs 单一 HTML 文件），使用前请以 SKILL.md 为准并自行核实。
- 克隆外部 GitHub 仓库时请自行确认仓库可信，技能未提供对不可信代码的安全处理指引。
- 唯一外部依赖为 Google Fonts CDN，中国大陆网络下可能加载失败或退化显示。
- 无许可证、版本与维护信息，引用文件（build.sh、styles.css 等）未在审阅材料中提供，运行效果未经执行验证。
这个 Skill 能做什么，适合哪些场景？
这是一个 Claude Code 技能，能将任意代码库转化为精美的交互式单页 HTML 课程。课程通过滚动式导航、动画可视化、内嵌测验和代码与通俗英文对照翻译，向非技术背景的“氛围编程者”讲解代码如何运作。技能会先深入分析代码库，再设计 4-6 个模块的课程大纲，最后组装出一个可离线运行的 HTML 课程目录。它明确面向不打算成为工程师、只想更好地指挥 AI 编程工具的用户。
技能读取本地目录或通过 git clone 拉取 GitHub 仓库，通读关键文件、追踪数据流、识别主要组件和技术栈；然后按“从产品行为到代码实现”的路径设计 4-6 个教学模块（复杂代码库会先写模块简报并用子代理并行撰写）；输出是一个课程目录，包含从 references/ 原样复制的 styles.css、main.js、build.sh，逐模块手写的 HTML 片段，以及由 build.sh 组装出的 index.html。课程内必须包含群聊动画、消息流动画、代码对照翻译、每模块至少一个测验和术语悬浮提示，且代码片段必须原样摘自真实代码库。
- 用自然语言指挥 AI 造了个应用的氛围编程者，想搞懂自己项目在底层到底发生了什么
- 在 GitHub 上发现有趣的开源项目，想通过互动课程快速理解其架构
- 想提升与工程师沟通能力的产品经理或创业者，需要掌握软件的基本词汇
- 经常被 AI 的 bug 循环卡住的人，想建立调试直觉、识别 AI 幻觉和坏模式
- 技术博主或教育者，想把某个仓库转化为可分享的教学材料
这个 Skill 有哪些优点和局限？
- 输出完全自包含，无需安装即可在浏览器离线打开（唯一外部依赖是 Google Fonts CDN）
- 设计理念清晰：先构建后理解、测验考应用而非记忆、禁止重复套用比喻、代码片段原样摘录
- 强制五类互动元素（群聊动画、数据流动画、代码翻译、测验、术语提示），保证课程质量下限
- 目录化输出避免重复生成样板代码，复杂代码库还支持子代理并行撰写以控制输出规模
- 许可证未知，商用前需向作者确认
- 仓库未提供测试套件，实际生成质量依赖模型能力，无量化评估
- README 称输出为单个 HTML 文件，SKILL.md 则描述为目录结构经 build.sh 组装，两处表述不完全一致
- 生成的课程需要用户目标与“氛围编程者”画像匹配；对想系统学工程知识的读者，深度有限
- 并行路径依赖子代理调度能力，普通对话式客户端可能无法照搬
如何安装这个 Skill？
来源仅记录了 Claude Code 的一种安装方式：将 codebase-to-course 文件夹复制到 ~/.claude/skills/ 目录。未提供其他平台的安装步骤，也未说明许可证。
如何使用这个 Skill？
1) 在 Claude Code 中打开任意项目；2) 输入触发语，例如“Turn this into a course”“Explain this codebase interactively”“Make a course from https://github.com/user/repo”，也可指定本地路径如“turn ./my-project into a course”；3) 技能会直接构建课程（不先征求大纲确认），完成后运行 build.sh 组装 index.html 并在浏览器中打开。首次使用且未指定代码库时，技能会先自我介绍并说明可接受本地文件夹、GitHub 链接或当前项目。