用途
Content Evaluation Framework 是一个用于评估教育类书籍章节、课程或教学内容质量的技能。它提供一套系统化、可量化的六类评分标准,帮助在内容创作的不同阶段进行客观、基于证据的质量评估。
主要能力
该技能围绕六个类别进行评估,其中五个为加权类别,一个为通过/失败门槛:
- 技术准确性(权重30%):代码正确性、类型提示、解释、示例是否如所述工作
- 教学有效性(权重25%):先展示后解释模式、渐进复杂度、高质量练习
- 写作质量(权重20%):可读性(Flesch-Kincaid 8-10)、语气、清晰度、年级适配性
- 结构与组织(权重15%):学习目标达成、逻辑流畅、适当长度、过渡
- AI优先教学(权重10%):共同学习伙伴关系、三角色框架、九大支柱对齐、规格即语法
- 宪法合规性(通过/失败):必须通过所有不可协商的宪法要求,包括九大支柱对齐(门槛)
评分等级分为:优秀(90-100%)、良好(75-89%)、需改进(50-74%)、不足(低于50%)。最终加权分数计算公式为:技术×0.30 + 教学×0.25 + 写作×0.20 + 结构×0.15 + AI优先×0.10。
使用方式
评估流程包含以下步骤:
- 准备上下文:收集待评估内容、相关规格/计划/任务文件、宪法文件、学习目标、输出风格模板
- 加载详细评分标准:读取 references/rubric-details.md
- 首先评估宪法合规性:读取 references/constitution-checklist.md,若失败则停止评估并报告违规
- 对每个加权类别评分:依据评分标准评估,记录具体证据(引用、行号),提供改进建议
- 计算加权分数:应用公式,将等级分数转换为数值(优秀95%、良好82%、需改进62%、不足40%)
- 生成评估报告:读取 references/evaluation-template.md,完成所有部分
- 传达结果:清晰结论、基于证据的反馈、优先改进项、鼓励
该技能可通过关键词触发,如“evaluate [lesson|content|chapter|preface]”、“check quality”、“run content-evaluation-framework”、“score this content”、“is this ready for publication”。适用于 apps/learn-app/docs/ 下的 *.md 文件,以及包含 learning_objectives 的 YAML frontmatter 文件。
适用场景
- 迭代起草期间:中期质量检查,及早发现问题
- 课程/章节完成后:进入下一内容单元前的综合评估
- 按需审查请求:用户明确要求质量评估时
- 验证阶段前:作为 SDD Validate 阶段工作流的一部分进行最终签核
限制
- 宪法合规性是硬性门槛,若失败则内容无法继续,无论加权分数如何
- 最低接受阈值为:宪法合规通过、总体加权分数≥75%、无任何类别低于50%
- 若宪法文件缺失,则无法评估,必须停止
- 若评分标准文件不可用,则使用嵌入式摘要标准,并标记输出为“PARTIAL - rubric unavailable”
- 评估必须基于证据,禁止在没有引用和行号的情况下给出分数
- 该技能不涉及收费、价格或平台信息,这些内容暂未提供