ai-courseify

# Courseify - AI 驱动的课程内容生成工具 > **状态**: ✅ 核心功能已实现 > **定位**: 从课程规划到多平台导出的完整创作辅助工具 **核心价值**: 帮助教师、培训师和内容创作者从零完成课程设计,支持全领域课程、三种创作模式、完整创作流程,并与 Notion/飞书/网易云课堂等平台无缝对接 --- ## ⚠️ 产品边界 **Courseify 专注于课程内容设计和教学规划**,与在线教学平台互补。 ✅ **做什么**: - 全领域课程设计 (编程/设计/商业/语言等) - 三种创作模式 (引导/快速/混合) - 课程大纲生成与优化 - 章节内容创作辅助 - 练习题和案例设计 - 视频脚本生成 - 导出到 Notion/飞书/网易云课堂 ❌ **不做什么**: - 视频录制和剪辑 - 直播授课平台 - 学员管理系统 - 作业批改系统 --- ## 🎯 核心功能 ### 1. 全领域课程支持支持主流课程领域: - 💻 **编程开发** - 编程语言/框架/工具 - 🎨 **设计创意** - UI/UX/平面/视频 - 💼 **商业管理** - 运营/营销/管理 - 🌍 **语言学习** - 英语/日语等 - 📊 **数据分析** - 数据科学/分析/BI - 🎓 **学术课程** - 学科知识 - 🛠️ **职业技能** - 职场工具/技能 - 🧠 **软技能** - 沟通/思维/时间管理 ### 2. 三种创作模式 **引导模式 (Coach)** - 100%原创 - AI 逐章引导思考教学逻辑 - 提问式激发课程设计 - 质量实时检查 - 适合: 追求原创的教师 **快速模式 (Express)** - 快速迭代 - AI 快速生成完整大纲 - 基于规格快速输出 - 适合: 快速原型,灵感激发 **混合模式 (Hybrid)** - 平衡效率与原创 - AI 生成框架和关键点 - 用户填充教学细节 - 适合: 需要结构指引的创作者 ### 3. 完整创作流程从规划到导出的完整工作流: **课程规划阶段**: 1. `/spec` - 定义课程规格 2. `/objective` - 设定学习目标 3. `/structure` - 设计课程结构 **内容创作阶段**: 4. `/outline` - 生成课程大纲 5. `/content` - 创作章节内容 6. `/exercise` - 生成练习题 7. `/script` - 生成视频脚本 **质量与导出**: 8. `/review` - 内容质量评估 9. `/export` - 导出到多平台 ### 4. 多平台导出 **在线课程平台**: - ✅ 网易云课堂 CSV 导入格式 - ✅ 腾讯课堂大纲格式 - ✅ Udemy 课程结构 **知识库平台**: - ✅ Notion Database 导入 - ✅ 飞书文档格式 - ✅ 语雀目录结构 **通用格式**: - ✅ Markdown 文档 - ✅ Excel 大纲表格 - ✅ HTML 静态页面 --- ## ✨ 新功能: 参考课程系统 v0.2.0 基于你收集的优质专栏,Courseify 现在可以: ### 🎯 智能推荐 (`/reference`) - 根据你的课程规格,自动匹配相似的优质专栏 - Top 3 推荐,每个都说明参考价值 - 领域/难度/关键词多维度匹配 ### 📊 结构分析 (`/analyze`) - 深入剖析专栏的章节结构和进阶路径 - 识别教学设计特色(如预习篇/基础篇/进阶篇划分) - 提供可落地的借鉴建议 ### 💡 集成参考能力 - `/outline` - 设计大纲时可参考优秀专栏的结构 - `/review` - 质量对标,与行业标杆对比 ### 📚 如何使用 ```bash # 1. 添加你的专栏资料到 reference-courses/ cp -r ~/Downloads/专栏/* reference-courses/ # 2. 扫描生成索引 bash scripts/bash/scan-references.sh # 3. 创建课程时查看推荐 courseify init "我的课程" /spec /reference # 智能推荐相似专栏 /analyze Flutter核心技术与实战 # 深入分析 ``` **注意**: 专栏数据是你的私人资料,不会提交到 Git 仓库。 --- ## ✨ 新功能: 风格模拟系统 v0.3.0 学习大师的教学方法,AI 以优秀专栏作者的风格辅助你创作! ### 🎭 风格模拟 (`/mimic`) 从优秀专栏作者中学习课程设计方法: - **陈航** (Flutter核心技术与实战) - 技术深入、原理讲解、实战结合 - **林晓斌** (MySQL实战45讲) - 问题驱动、深入浅出、生产案例 - **倪朋飞** (Linux性能优化实战) - 实战为主、工具演示、性能分析 ### 💡 如何使用 ```bash # 1. 查看可模拟的作者 /mimic list # 2. 激活某个作者的风格 /mimic activate 陈航 # 3. AI 将以该作者的方式辅助你创作 /outline # 以陈航的风格设计大纲 /content # 以陈航的风格创作内容 /review # 以陈航的标准评估质量 # 4. 退出风格模拟 /mimic deactivate ``` ### 🎯 核心价值 - 📚 **学习专业方法**: 从行业标杆学习课程设计思路 - 🎭 **风格指导**: AI 按照大师的方式引导你思考 - 🚀 **快速提升**: 借鉴成熟的教学模式 - ✍️ **保持原创**: 学习方法而非照搬内容 ### 📖 详细文档查看 [风格模拟系统使用指南](docs/MIMIC_GUIDE.md) 了解更多。 --- ## 📦 安装 ```bash npm install -g ai-courseify ``` 或本地开发: ```bash git clone https://github.com/wordflowlab/courseify.git cd courseify npm install npm run build ``` --- ## 🚀 快速开始 ### 1. 初始化课程项目 ```bash # 交互式选择 AI 助手、课程领域、脚本类型 courseify init "我的第一门课" cd "我的第一门课" ``` **支持13个AI编程助手**: - Claude Code, Cursor, Gemini CLI - Windsurf, Roo Code, GitHub Copilot - Qwen Code, OpenCode, Codex CLI - Kilo Code, Auggie CLI, CodeBuddy, Amazon Q Developer ### 2. 定义课程规格 ```bash /spec ``` AI 引导你填写: - 领域: 编程开发/设计创意/商业管理等 - 难度: 入门/进阶/高级 - 时长: 10小时/30课时等 - 受众: 学生/职场新人/专业人士 - 格式: 视频/文档/音频/混合 - 平台: 网易云课堂/B站/Notion等 - 语言: 中文/英文/双语 ### 3. 设计课程 **使用 Slash Commands 完成课程设计**: ```bash /objective # 1. 设定学习目标 /structure # 2. 设计课程结构 /outline # 3. 生成课程大纲(三种模式) /content # 4. 创作章节内容 /exercise # 5. 生成练习题 /script # 6. 生成视频脚本 /review # 7. 质量评估 /export # 8. 导出到平台 ``` **三种创作模式** (交互式选择): ```bash /outline # AI 会询问你选择模式 # AI: "请选择课程大纲创作模式: # 1. 引导模式 (Coach) - 逐章引导,深度思考 # 2. 快速模式 (Express) - 快速生成完整大纲 # 3. 混合模式 (Hybrid) - AI 生成框架,你填充内容" # # 用户: "1" # AI: "已选择引导模式,开始设计..." ``` ### 4. 导出到平台 ```bash /export # 交互式选择导出平台 ``` AI 会询问你想导出到: 1. **Notion** - 生成 Database 导入格式 2. **飞书** - 生成文档结构和内容 3. **网易云课堂** - 生成 CSV 课程大纲 4. **Excel** - 导出大纲表格 5. **全部** - 一次性导出所有格式 --- ## 📚 完整命令列表 ### 项目管理 (1个) - `courseify init <项目名>` - 创建新项目 ### 课程设计流程 (9个) - `/spec` - 定义课程规格 - `/objective` - 设定学习目标 - `/structure` - 设计课程结构 - `/outline` - 生成课程大纲 (三种模式) - `/content` - 创作章节内容 - `/exercise` - 生成练习题 - `/script` - 生成视频脚本 - `/review` - 质量评估 - `/export` - 导出到多平台 --- ## 🏗 架构设计 Courseify 基于三层架构: ``` Markdown指令层 (templates/commands/*.md) → 定义AI提示词和工作流程 → 引导AI如何与用户交互 TypeScript CLI层 (src/cli.ts) → 命令行界面 → 调用Bash脚本 Bash脚本层 (scripts/bash/*.sh) → 文件操作和项目管理 → 输出JSON供AI使用 ``` ### 为什么这样设计? 1. **灵活性**: Markdown模板可以随时调整,无需重新编译 2. **可维护性**: 三层分离,职责清晰 3. **AI友好**: Markdown格式易于AI理解和执行 4. **跨平台**: 支持Bash和PowerShell --- ## 🎨 创作模式详解 ### 引导模式 (Coach) **理念**: AI是你的课程设计顾问,不是代笔人 **流程**: 1. 逐章引导设计 2. 每章提出 6 个引导问题 3. 逐步检查设计质量 4. 发现问题立即指出 5. 绝不提供具体大纲内容 **适合**: - 追求100%原创 - 有时间深度思考 - 想提升课程设计能力 ### 快速模式 (Express) **理念**: AI快速生成,你快速迭代 **流程**: 1. 分析规格、目标、结构 2. 直接生成完整大纲 3. 保证逻辑清晰和实用性 4. 用户可修改调整 **适合**: - 需要快速原型 - 寻找灵感 - 学习课程结构 ### 混合模式 (Hybrid) **理念**: AI搭框架,你填内容 **流程**: 1. AI生成章节框架和知识点 2. 标注[待填充]部分 3. 提供教学建议 4. 用户逐项填充 **适合**: - 需要结构指引 - 平衡效率与原创 - 初学者学习设计 --- ## 📖 使用示例 ### 示例 1: 创作编程入门课程 ```bash # 1. 初始化项目 courseify init "Python编程入门" cd "Python编程入门" # 2. 定义规格 /spec # AI引导: 选择"编程开发"、"入门"、"15小时"、"学生" # 3. 设定目标 /objective # AI引导: 设定知识点、技能、学习成果 # 4. 设计结构 /structure # AI引导: 规划 10 章,每章 3-5 课时 # 5. 生成大纲 /outline # AI询问: "选择模式: 1.引导 2.快速 3.混合" # 用户: "1" # AI逐章引导设计... # 6. 创作内容 /content # 7. 生成练习题 /exercise # 8. 生成视频脚本 /script # 9. 质量评估 /review # 10. 导出到B站 /export # AI询问: "选择平台: 1.Notion 2.飞书 3.网易云课堂..." # 用户: "5" ``` --- ## 🛣 开发路线图 **Phase 1: MVP** (已完成 ✅ v0.1.0) - 核心命令实现 - 三种创作模式 - 基础质量评估 - 多平台导出框架 **Phase 2: 内容增强** (规划中 📋 v0.2.0) - 更智能的教学建议 - 案例库和模板库 - 互动练习题生成 - 视频脚本优化 **Phase 3: 平台集成** (未来 🔮 v0.3.0) - Notion/飞书API直接发布 - 网易云课堂批量导入 - B站课程描述生成 - YouTube字幕生成 **Phase 4: AI 增强** (未来 🔮 v0.4.0) - 课程难度自动分析 - 教学效果预测 - 个性化学习路径生成 - 多语言课程支持 --- ## 🤝 贡献欢迎提交 Issue 和 Pull Request! --- ## 📄 License MIT License --- ## 🙏 致谢本项目架构参考了 [Musicify](https://github.com/wordflowlab/musicify) 项目。