ai-courseify

Courseify - AI 驱动的课程内容生成工具

版本: v0.1.0 状态: ✅ 核心功能已实现 定位: 从课程规划到多平台导出的完整创作辅助工具

核心价值: 帮助教师、培训师和内容创作者从零完成课程设计,支持全领域课程、三种创作模式、完整创作流程,并与 Notion/飞书/网易云课堂等平台无缝对接

⚠️ 产品边界

Courseify 专注于课程内容设计和教学规划,与在线教学平台互补。

✅ 做什么:

• 全领域课程设计 (编程/设计/商业/语言等)
• 三种创作模式 (引导/快速/混合)
• 课程大纲生成与优化
• 章节内容创作辅助
• 练习题和案例设计
• 视频脚本生成
• 导出到 Notion/飞书/网易云课堂

❌ 不做什么:

• 视频录制和剪辑
• 直播授课平台
• 学员管理系统
• 作业批改系统

🎯 核心功能

1. 全领域课程支持

支持主流课程领域:

• 💻 编程开发 - 编程语言/框架/工具
• 🎨 设计创意 - UI/UX/平面/视频
• 💼 商业管理 - 运营/营销/管理
• 🌍 语言学习 - 英语/日语等
• 📊 数据分析 - 数据科学/分析/BI
• 🎓 学术课程 - 学科知识
• 🛠️ 职业技能 - 职场工具/技能
• 🧠 软技能 - 沟通/思维/时间管理

2. 三种创作模式

引导模式 (Coach) - 100%原创

• AI 逐章引导思考教学逻辑
• 提问式激发课程设计
• 质量实时检查
• 适合: 追求原创的教师

快速模式 (Express) - 快速迭代

• AI 快速生成完整大纲
• 基于规格快速输出
• 适合: 快速原型,灵感激发

混合模式 (Hybrid) - 平衡效率与原创

• AI 生成框架和关键点
• 用户填充教学细节
• 适合: 需要结构指引的创作者

3. 完整创作流程

从规划到导出的完整工作流:

课程规划阶段:

• /spec - 定义课程规格
• /objective - 设定学习目标
• /structure - 设计课程结构

内容创作阶段: 4. /outline - 生成课程大纲 5. /content - 创作章节内容 6. /exercise - 生成练习题 7. /script - 生成视频脚本

质量与导出: 8. /review - 内容质量评估 9. /export - 导出到多平台

4. 多平台导出

在线课程平台:

• ✅ 网易云课堂 CSV 导入格式
• ✅ 腾讯课堂大纲格式
• ✅ Udemy 课程结构

知识库平台:

• ✅ Notion Database 导入
• ✅ 飞书文档格式
• ✅ 语雀目录结构

通用格式:

• ✅ Markdown 文档
• ✅ Excel 大纲表格
• ✅ HTML 静态页面

📦 安装

npm install -g ai-courseify

或本地开发:

git clone https://github.com/wordflowlab/courseify.git
cd courseify
npm install
npm run build

🚀 快速开始

1. 初始化课程项目

# 交互式选择 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. 定义课程规格

/spec

AI 引导你填写:

• 领域: 编程开发/设计创意/商业管理等
• 难度: 入门/进阶/高级
• 时长: 10小时/30课时等
• 受众: 学生/职场新人/专业人士
• 格式: 视频/文档/音频/混合
• 平台: 网易云课堂/B站/Notion等
• 语言: 中文/英文/双语

3. 设计课程

使用 Slash Commands 完成课程设计:

/objective    # 1. 设定学习目标
/structure    # 2. 设计课程结构
/outline      # 3. 生成课程大纲(三种模式)
/content      # 4. 创作章节内容
/exercise     # 5. 生成练习题
/script       # 6. 生成视频脚本
/review       # 7. 质量评估
/export       # 8. 导出到平台

三种创作模式 (交互式选择):

/outline      # AI 会询问你选择模式
# AI: "请选择课程大纲创作模式:
#  1. 引导模式 (Coach) - 逐章引导,深度思考
#  2. 快速模式 (Express) - 快速生成完整大纲
#  3. 混合模式 (Hybrid) - AI 生成框架,你填充内容"
#
# 用户: "1"
# AI: "已选择引导模式,开始设计..."

4. 导出到平台

/export       # 交互式选择导出平台

AI 会询问你想导出到:

• Notion - 生成 Database 导入格式
• 飞书 - 生成文档结构和内容
• 网易云课堂 - 生成 CSV 课程大纲
• Excel - 导出大纲表格
• 全部 - 一次性导出所有格式

📚 完整命令列表

项目管理 (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使用

为什么这样设计?

• 灵活性: Markdown模板可以随时调整,无需重新编译
• 可维护性: 三层分离,职责清晰
• AI友好: Markdown格式易于AI理解和执行
• 跨平台: 支持Bash和PowerShell

🎨 创作模式详解

引导模式 (Coach)

理念: AI是你的课程设计顾问,不是代笔人

流程:

• 逐章引导设计
• 每章提出 6 个引导问题
• 逐步检查设计质量
• 发现问题立即指出
• 绝不提供具体大纲内容

适合:

• 追求100%原创
• 有时间深度思考
• 想提升课程设计能力

快速模式 (Express)

理念: AI快速生成,你快速迭代

流程:

• 分析规格、目标、结构
• 直接生成完整大纲
• 保证逻辑清晰和实用性
• 用户可修改调整

适合:

• 需要快速原型
• 寻找灵感
• 学习课程结构

混合模式 (Hybrid)

理念: AI搭框架,你填内容

流程:

• AI生成章节框架和知识点
• 标注[待填充]部分
• 提供教学建议
• 用户逐项填充

适合:

• 需要结构指引
• 平衡效率与原创
• 初学者学习设计

📖 使用示例

示例 1: 创作编程入门课程

# 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 项目。

版本: v0.1.0 发布日期: 2025-11-01 状态: ✅ 核心功能完成,支持完整课程设计流程