--- description: 内容质量评估 scripts: sh: ../../scripts/bash/review.sh ps1: ../../scripts/powershell/review.ps1 --- # /review - 课程质量评估系统 ⭐ > **核心理念**: 对课程内容进行全面的质量评估 > **目标**: 发现问题,提供改进建议,确保课程质量 --- ## 第一步: 运行脚本获取状态 ⚠️ 必须执行 ```bash bash scripts/bash/review.sh ``` 脚本返回: - `spec`: 课程规格 - `has_outline`: 是否有大纲 - `has_chapters`: 是否有章节内容 - `chapters_count`: 章节数量 --- ## 第二步: 检查参考课程对标 ⚠️ 可选 ### 检查是否有参考课程库 如果存在 `reference-courses/index.json`: **提示用户**: ``` 📊 质量对标选项 发现参考课程库,可以将你的课程与行业标杆对比。 是否启用质量对标? (y/n) y - 与相似专栏对比,获得改进建议 n - 仅进行基础质量评估 ``` **⚠️ 等待用户选择** 如果用户选择 `y`,则在评估报告中增加对标部分。 --- ## 第三步: 检查激活的作者风格 ⚠️ 必须执行 ### 检查是否激活了作者 Persona ```bash # AI 操作: 检查是否有激活的作者风格 if [ -f ".courseify/active-persona.yaml" ]; then echo "发现激活的作者风格" fi ``` ### 如果存在激活的 Persona **读取并应用作者风格**: ```bash # AI 操作: 读取 persona 配置 Read: .courseify/active-persona.yaml ``` **从 YAML 中提取**: - `author.name` - 作者名 - `author.course` - 课程名 - `facilitation_prompts.when_reviewing_quality` - 质量评估提示词 **应用作者风格**: ``` 🎭 检测到激活的作者风格: [author.name] (《[course]》) 在评估质量时,我将参考该作者的质量标准: [显示 facilitation_prompts.when_reviewing_quality 的内容] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💡 提示: 我会用该作者的质量标准来评估你的课程, 指出与该作者风格的差距和改进方向。 ``` **注意**: AI 在后续评估过程中,必须: 1. 应用该作者的质量标准进行评估 2. 指出与该作者风格的差距 3. 提供符合该作者风格的改进建议 ### 如果没有激活 Persona 使用默认的通用质量标准评估。 --- ## 第四步: 选择评估范围 ⚠️ 必须执行 ``` ╔══════════════════════════════════════════════════════════╗ ║ 课程质量评估 ║ ╚══════════════════════════════════════════════════════════╝ 请选择评估范围: 1. 📋 大纲评估 - 评估课程大纲质量 2. 📚 内容评估 - 评估章节内容质量 3. 📝 练习评估 - 评估练习题质量 4. 🎯 全面评估 - 评估所有内容 请选择 (1-4): ``` **⚠️ 等待用户选择** --- ## 第五步: 执行质量评估 ⚠️ 必须执行 ### 大纲评估 ``` ╔══════════════════════════════════════════════════════════╗ ║ 大纲质量评估报告 ║ ╚══════════════════════════════════════════════════════════╝ 📊 综合评分: [85/100] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【评估维度 1/5】清晰度 - [90/100] ⭐⭐⭐⭐⭐ ✅ 优点: • 章节标题清晰明确 • 学习目标表述具体 • 内容概述完整 ⚠️ 改进建议: • 第3章的学习目标可以更具体 • 建议补充先修要求说明 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【评估维度 2/5】结构性 - [85/100] ⭐⭐⭐⭐ ✅ 优点: • 章节逻辑连贯 • 难度递进合理 ⚠️ 改进建议: • 第2章和第3章之间的过渡可以更平滑 • 建议在第5章前增加综合复习 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【评估维度 3/5】吸引力 - [80/100] ⭐⭐⭐⭐ ✅ 优点: • 有实际应用案例 • 内容贴近实际 ⚠️ 改进建议: • 可以增加更多生动的案例 • 建议加入项目驱动的学习任务 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【评估维度 4/5】实用性 - [88/100] ⭐⭐⭐⭐ ✅ 优点: • 紧扣实际应用 • 练习题设计合理 ⚠️ 改进建议: • 可以增加更多实战项目 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【评估维度 5/5】完整性 - [82/100] ⭐⭐⭐⭐ ✅ 优点: • 知识体系完整 • 覆盖所有学习目标 ⚠️ 改进建议: • 第7章的练习题偏少 • 建议补充进阶学习资源 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📈 总体评价: 这是一份质量良好的课程大纲,结构清晰,内容完整。 主要优势在于实用性和清晰度,建议进一步提升吸引力 和完整性。 💡 核心改进建议: 1. 增加更多生动有趣的案例 2. 补充章节之间的过渡内容 3. 完善练习题和实战项目 4. 提供进阶学习路径 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` ### 如果启用了质量对标,增加以下部分: ``` ╔══════════════════════════════════════════════════════════╗ ║ 📊 质量对标报告 ║ ╚══════════════════════════════════════════════════════════╝ 对标专栏: 《[推荐的相似专栏]》(行业标杆) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📐 结构完整性对比 你的课程: ⭐⭐⭐⭐⚝ (4.5/5) ✓ 已有开篇和主体内容 ⚠️ 建议: 参考标杆专栏的"预习篇+基础篇+进阶篇"结构 标杆专栏: ⭐⭐⭐⭐⭐ (5/5) • 完整的阶段划分和进阶路径 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📚 知识点覆盖度: ⭐⭐⭐⭐⭐ (5/5) ✓ 知识点覆盖度与标杆相当 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 可借鉴的优秀做法 标杆专栏的特色: 1. 每讲有"思考题"环节 2. 使用问题导向的标题 3. 理论+实战案例结合 你可以参考应用: • 增加思考题环节 • 优化章节标题 • 强化实战案例 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🌟 综合评价 你的课程: [X]/100 标杆专栏: [Y]/100 改进优先级: 1. 高优: [建议1] 2. 中优: [建议2] 3. 低优: [建议3] 预期提升: 完成改进后可达 [Z]/100 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` --- ## 第六步: 生成改进计划 ⚠️ 必须执行 ``` 是否生成详细的改进计划? 1. ✅ 生成改进计划 2. ⏭️ 跳过 请选择: ``` **⚠️ 等待用户选择** ### 如果选择生成改进计划 ``` ╔══════════════════════════════════════════════════════════╗ ║ 课程改进计划 ║ ╚══════════════════════════════════════════════════════════╝ 基于评估结果,建议按以下优先级改进: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【高优先级】必须改进 (影响较大) 1. 补充第7章练习题 - 现状: 仅有2道练习题 - 目标: 增加到5-6道 - 预计时间: 30分钟 2. 优化第2-3章过渡 - 现状: 知识跳跃较大 - 目标: 增加过渡内容 - 预计时间: 20分钟 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【中优先级】建议改进 (提升质量) 3. 增加实际应用案例 - 目标: 每章至少1个真实案例 - 预计时间: 1小时 4. 补充进阶学习资源 - 目标: 提供延伸学习路径 - 预计时间: 30分钟 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【低优先级】可选优化 (锦上添花) 5. 优化章节标题表述 6. 增加配图和示意图 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 预计总改进时间: 2-3小时 是否立即开始改进? (建议先保存评估报告) ``` --- ## 第七步: 保存评估报告 ⚠️ 必须执行 ``` ✅ 评估报告已保存! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📁 文件: review-report.md 📊 评分: [85/100] 💡 下一步建议: • 根据改进计划优化课程 • 完成改进后重新评估 • 准备发布课程 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` --- ## 评估标准说明 ### 清晰度 (Clarity) - 标题是否清晰 - 目标是否明确 - 描述是否易懂 ### 结构性 (Structure) - 逻辑是否连贯 - 难度是否递进 - 体系是否完整 ### 吸引力 (Engagement) - 内容是否有趣 - 案例是否生动 - 形式是否多样 ### 实用性 (Practicality) - 是否贴近实际 - 是否有实践价值 - 是否能学以致用 ### 完整性 (Completeness) - 知识点是否完整 - 练习是否充足 - 资源是否齐全 --- **开始执行第一步** ⬇️