📝

ProMentor 是一个 AI Coding Agent Skill，扫描开源项目架构后自动生成带讲义、源码导读、Lab、自动测试、AI Hint、Code Review 的阶梯式课程，带你亲手把项目重新实现一遍。实测演示：GopherAI 项目生成 7 章课程，5/5 测试通过，提交得分 100%。

ProMentor：把任何 GitHub 项目变成阶梯式工程课程，learn in practice

本文转载自小红书（rainLyn），已补充 GitHub 元数据验证与完整实操演示。

原文观点

GitHub 上有很多优秀的开源项目，但大多数人拿到项目后都是这样：

Clone → 看 README → 点进 src → 不停跳转 → 一脸懵 → 放弃。

问题不是项目太难，而是——开源项目从来就不是为「学习」设计的，它是为运行设计的。

于是作者做了 ProMentor：一套带你 learn in practice 的 skill，已开源放在 GitHub 上。

它不会直接帮你解释代码，而是先分析整个项目的架构、调用链和核心设计，再自动生成一套完整的学习课程。每个 Chapter 都有：

📖 讲义
🔍 源码导读
💻 Practice
✅ 自动测试
💬 AI Hint
🧠 Code Review

你不是在看源码，而是在一步一步，把这个项目重新实现出来。

📊 GitHub 数据验证

项目	数据
仓库	rainLyn/ProMentor
Stars	30 ⭐
Forks	0
创建时间	2026-07-31（约 1 周）
License	未标注
依赖	零依赖、无数据库——纯 Skill 指令文件

⚠️ 项目非常新（创建约 1 周、30⭐），理念验证阶段，建议关注迭代。

🔧 工作原理

ProMentor 是一个 AI Coding Agent Skill：把 promentor.md 复制到 .{YourAgent}/skills/promentor 目录即可，无需安装任何依赖、不需要数据库——它只是告诉 AI 怎么当一个好老师。

命令速查

命令	说明
`/promentor init`	分析项目，生成课程
`/promentor`	课程面板（目录 + 进度）
`/promentor learn <ch>`	进入指定 Chapter 学习
`/promentor test`	运行行为测试
`/promentor hint`	动态生成分层提示
`/promentor submit`	正式提交，锁定成绩
`/promentor review`	对比实现 vs 原始源码
`/promentor progress`	查看总进度

学习模型

Learn Concept     （AI 讲解讲义）
    ↓
Read Source Code  （AI 带你读标注过的源码）
    ↓
Implement Lab     （手写核心逻辑）
    ↓
Run Tests         （/promentor test）
    ↓
Submit & Review   （/promentor submit → /promentor review）
    ↓
Master System Design

🎬 实操演示（GopherAI 项目）

笔记配图完整展示了在 GopherAI-v2（Go 后端 + Vue 前端，48 个源文件 ~4268 行）上的实战过程：

1️⃣ /promentor init — 扫描并生成课程大纲

自动识别项目为 Go 后端 + Vue 前端，生成《GopherAI 内部设计 — AI 多模型对话平台》课程：

章节	主题	难度
Ch0	项目引导与配置系统	easy
Ch1	错误码与统一响应	easy
Ch2	JWT 认证系统	mid
Ch3	分层架构 Router→Controller→Service→DAO	mid
Ch4	AI 模型插件系统（工厂模式，4 种模型实现）	hard
Ch5	会话与消息状态管理（两级 Map + 回调注入）	hard
Ch6	异步消息持久化（RabbitMQ）	mid
Final	组装 Mini GopherAI（接口兼容原始设计）	hard

带依赖关系链（Ch0→Ch1→…→Ch6→Final），并智能聚焦：前端 Vue 与外围功能（tts/image/mcp）不纳入课程。

2️⃣ /promentor learn ch0 — 讲义 + 源码导读 + Lab

讲义讲「Go 服务从 main() 到 r.Run() 之间发生了什么」，源码导读精确到行号（main.go:52-73 启动顺序、config.go:99-165 单例 GetConfig 且点出”没有 sync.Once 是 bug 吗”），然后给出 Lab 任务：在 .promentor/chapters/ch00-bootstrap/ 下自己写配置加载与路由初始化。

3️⃣ /promentor test — 行为测试自动判题

运行 5 个行为测试（TestLoadConfig_ValidTOML 等），5/5 全绿，并给出代码评价：”两个文件都单功能直出，刚好不超过 28 行的函数——Linus 看了会点头。”

4️⃣ /promentor submit — 提交锁定成绩

全量测试通过后保存提交，进度写入 .promentor/progress.json，显示”提交成功！5/5 全部通过，得分 100%”，并提示下一章。

5️⃣ /promentor review — AI Code Review 对比原版

生成「你的实现 vs 原始源码」对比表：函数长度、错误处理、配置加载参数化、无全局状态、API 版本化、健康检查——甚至指出你实际上纠正了原项目的一个坏味道（原项目 InitConfig() 用 log.Fatal 硬编码路径，你的参数化版本更好）。

💡 为什么是 ProMentor

比直接读源码有路线：不是随机跳转，是有依赖关系的阶梯式学习路径
比视频课深入：不是看别人写代码，是自己亲手实现核心逻辑
比博客系统化：不是碎片化知识点，是完整理解一个系统的设计哲学
AI 原生：课程由 AI 生成、AI 讲解、AI 判题、AI Review，零内容生产成本

原文链接

https://xhslink.cn/o/4W0p0yYqDVH