mcpField
C
coverage-audit

coverage-audit

github.com/garethmanning其他921138 次安装6 天前更新
代码仓库

关于 coverage-audit

用于将课程框架与法规或认证要求清单逐项比对的审查技能,适用于不同学校和项目。它按直接、部分、间接或无覆盖分类,并生成覆盖表、CSV、差距摘要和统计数据,供人工判断参考。

主要功能

  1. 01逐项映射外部要求
  2. 02四级标注覆盖程度
  3. 03生成 Markdown 覆盖表
  4. 04导出匹配的 CSV
  5. 05汇总差距与覆盖统计

适用场景

  1. 01检查课程对法定要求的覆盖
  2. 02准备认证审查材料
  3. 03定位课程框架中的内容缺口

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/garethmanning/education-agent-skills --skill coverage-audit

安装后在 Claude Code 中输入/coverage-audit确认已加载。

详细介绍

此技能的作用

此技能会根据法定或认证要求清单审核课程框架,并生成结构化的覆盖情况表,展示框架中的哪些内容对应各项要求,以及对应程度如何。此技能不依赖特定框架:待审核的框架可以是任何学校的课程、任何学习方案或任何能力框架。要求清单可以是法定要求、认证标准,也可以是学校应当满足的任何外部核对清单。两项输入均不假定来自 REAL School、英国或任何其他特定背景。

此技能将每项要求的匹配程度分为四类:直接匹配(框架明确涉及该项要求)、部分匹配(框架涉及相关内容,但未涉及具体要求)、间接匹配(存在与要求略有关联的内容)或无匹配(框架内容与该项要求无关)。这套四级量表遵循 Webb(1997)的类别一致性逻辑,并将其应用于要求层面,而非条目层面。此技能会明确说明此处“覆盖”的含义:框架文档中是否出现相关主题。框架条目涉及某个要求主题,并不一定意味着该要求已按预期的认知深度得到充分教学、评估或落实。

此技能会生成三项输出:用于 PLC 或认证准备的 Markdown 覆盖情况表、便于在电子表格中筛选的对应 CSV,以及用于叙述性报告的文字版差距摘要。coverage_statistics 对象提供总览计数,便于快速浏览。这些输出是供专业人员判断的辅助材料,旨在减少课程协调员查找证据所花费的时间,而非取代确认覆盖情况所需的判断。

证据基础

Webb(1997)——这一经典的四维对齐框架将类别一致性确立为覆盖情况的基础维度:框架和要求清单是否涉及相同主题?此技能采用 Webb 的逻辑对匹配程度进行分类,但仅限于类别一致性和范围。知识深度对齐——即框架是否以要求的认知深度涵盖某项要求——明确不在此技能的范围内,并在“已知限制”中标明需由人工判断。

Porter 等人(2002)——已实施课程调查方法确立了此技能覆盖情况表所采用的“每项要求一行”方法:每项要求各占一行,并将框架内容映射到该项要求,而非反向映射。这样可以让没有框架内容覆盖的要求(差距行)与覆盖充分的要求同样醒目,也能避免输出自然倾向于围绕框架覆盖了什么来组织,而不是围绕要求清单要求什么来组织。

输入架构

必填输入。

  • framework — 正在审查的课程架构。接受来自 Developmental Band Translator 的带有分段标签的 JSON(用于按分段筛选),或包含能力和学习目标的纯 Markdown 或文本。如果带有分段标签,技能可以通过 band_filter 将审查范围限制在指定分段。如果是纯文本,则审查所有架构内容,不区分分段。
  • requirements — 法定或认证要求列表。接受 Markdown、CSV 或纯文本。每项要求都应带有标识符(编号、代码或标签),用于“要求 ID”列。如果没有标识符,技能会分配稳定的顺序 ID(R001、R002、……),并在前言中注明。

可选输入。

  • framework_name — 用于输出标题的易读标签。
  • requirements_source — 法定或认证机构的名称,用于输出标题。
  • band_filter — 将审查范围限制在指定分段(例如 "D,E")。仅当 framework 是带有分段标签的 JSON 时适用。若省略,则搜索所有架构内容。

必填输入示例。 REAL School Budapest 根据英国 RSHE 法定要求(2025 年 7 月)审查其身心健康课程:framework = REAL School Wellbeing Framework(带有分段标签或 Markdown);requirements = 英国 DfE 法定 RSHE 要求列表;framework_name = "REAL School Budapest Wellbeing Framework";requirements_source = "UK DfE Statutory RSHE, July 2025"。输出会将每一条 RSHE 法定要求列为一行,并将 REAL 架构中对应的内容(如有)映射到该要求,并按证据强度分类。

提示词

你是一名课程覆盖度审查助手。你的任务是根据要求列表审查课程架构,并生成结构化的覆盖表、差距摘要和覆盖统计数据。

流程

  1. 阅读要求列表。 确认每项要求都有稳定的标识符。如果没有标识符,则分配顺序 ID(R001、R002、……),并在输出前言中注明。搜索架构之前,先记录所有要求——不得跳过任何一项。
  2. 阅读架构。 如果带有分段标签,记录分段标签,并在提供了 band_filter 时应用该筛选条件。如果是纯文本,则将所有内容视为一个整体。
  3. 针对每项要求,在架构中搜索与其相关的内容:
    • 直接 — 架构明确且实质性地涵盖该要求。架构条目的主题、表述方式和意图与要求的主题、表述方式和意图高度一致。教师无需补充说明,即可将该条目作为覆盖证据。
    • 部分 — 架构涵盖相关内容,但未涉及该具体要求。主题有所重叠,但表述方式、深度或范围有所不同。教师可以将该条目作为部分证据,但需要补充背景说明。
    • 间接 — 架构包含与该要求略有关联的内容。主题相近但并不相同。证据基于推断,而非直接体现。
    • 无 — 架构中没有涉及该要求的内容。这是一个差距项。
  4. 生成 coverage_table — 每项要求一行,列为:要求 ID | 要求文本 | 覆盖内容 | 分段 | 证据强度 | 备注。
  5. 生成 coverage_csv — 以扁平 CSV 格式输出与 coverage_table 相同的数据。列名必须准确为:requirement_id, requirement_text, covered_by, bands, evidence_strength, notes。
  6. 编写 gap_summary — 用一个段落总结“无”和“间接”行中的要求。如果可能,按主题归纳相关差距。注明“无”和“间接”行的总数。
  7. 生成 coverage_statistics — 统计数量:total_requirements、directly_covered、partially_covered、not_covered(仅“无”行)。另行统计 indirectly_covered。

分类纪律

对证据强度进行分类时,应倾向于保守。若匹配需要审查者推断出超出框架文本直接表述范围的结论,则应归类为部分匹配或间接匹配,而非直接匹配。此技能的作用是为专业审查提供诚实的起点,而不是尽可能提高表面上的覆盖率。若通过激进分类让框架看起来已被全面覆盖,那么对于试图发现真实差距的认证机构或课程协调员而言,这样的框架并无助益。

输入

  • framework:{{framework}}
  • requirements:{{requirements}}
  • framework_name:{{framework_name}}
  • requirements_source:{{requirements_source}}
  • band_filter:{{band_filter}}

生成一个包含以下字段的 JSON 对象:coverage_table(Markdown 字符串)、coverage_csv(CSV 字符串)、gap_summary(字符串)、coverage_statistics(对象)。

示例输出

背景:针对英国 RSHE 法定要求,对 REAL School Budapest Wellbeing Framework 进行了审核,band_filter = "D,E"。

coverage_table(显示 8 行):

要求 ID要求文本覆盖内容学段证据强度备注
RSHE-D-01“积极、健康的友谊的特征……尊重、诚实、信任、忠诚、善意、慷慨、界限、隐私、同意以及冲突管理”“学生能够识别健康和不健康的关系模式,并清楚说明各自的原因。”D直接主题和意图高度匹配。
RSHE-D-02“与性同意、性剥削、虐待、诱骗、胁迫、骚扰相关的概念和法律”“学生理解,同意是一个持续、可撤回、明确表示同意的过程。”D部分框架从发展角度探讨了同意;法定要求还包括法律层面的阐释,以及未明确涉及的其他伤害类别。
RSHE-D-03“各类避孕方式的事实、有效性和可用选项”——无框架中没有涉及 D 或 E 学段的避孕内容。
RSHE-D-04“色情内容对性、关系和性别态度的影响”——无框架中没有直接对应内容。E 学段的数字健康内容涉及媒体影响,但未具体涉及色情内容。
RSHE-D-05“不同性传播感染(STI),包括 HIV/AIDs,如何传播以及如何降低风险”——无未发现 D 或 E 学段的 STI 内容。
RSHE-E-01“如何寻求并识别针对心理健康和身心健康的支持”“学生能够判断何时应为自己或同伴寻求帮助,并且至少知道两种可信赖的求助途径。”D部分框架在 D 学段涉及了这一要求;法定要求则将其安排在中学毕业阶段。E 学段没有对应内容,因此虽有部分覆盖,但学段不符。
RSHE-E-02“观看有害内容的影响”——间接E 学段的数字健康内容通常涉及科技使用及其对身心健康的影响,但没有具体讨论有害内容。
RSHE-E-03“我能够分析和评估自己的身份认同、价值观和自我价值感如何影响我与他人的互动方式”“学生能够分析身份认同、价值观和情境如何影响他们对关系的决定。”E直接在正确学段内,主题和意图高度匹配。

coverage_csv(对应行):

requirement_id,requirement_text,covered_by,bands,evidence_strength,notes
RSHE-D-01,"the characteristics of positive and healthy friendships… respect, honesty, trust, loyalty, kindness, generosity, boundaries, privacy, consent and the management of conflict","Students can identify healthy and unhealthy relationship patterns and articulate why each is so.",D,direct,Strong topical and intent match.
RSHE-D-02,"the concepts of, and laws relating to, sexual consent, sexual exploitation, abuse, grooming, coercion, harassment","Students understand consent as an ongoing, reversible, affirmative process.",D,partial,Framework addresses consent developmentally; statutory requirement includes legal framing not present.
RSHE-D-03,"the facts about the full range of contraceptive choices, efficacy and options available",,, none,No framework content addresses contraception at Bands D or E.
RSHE-D-04,"the impact of pornography on attitudes to sex, relationships and gender",,,none,No direct equivalent. Digital wellbeing content is adjacent but not specific.
RSHE-D-05,"how the different sexually transmitted infections (STIs), including HIV/AIDs, are transmitted",,, none,No STI content identified at Band D or E.
RSHE-E-01,"how to seek, and recognise, support for mental health and wellbeing","Students can identify when to seek help for themselves or a peer and know at least two trusted routes.",D,partial,Addressed at Band D not E; partial coverage at wrong band.
RSHE-E-02,"the impact of viewing harmful content",,,indirect,Digital wellbeing content is adjacent; harmful content not specifically addressed.
RSHE-E-03,"I can analyse and evaluate how my identity, values and sense of self-worth affect the way I interact with others","Students can analyse how identity, values, and context shape their decisions about relationships.",E,direct,Close topical and intent match.

gap_summary:抽样的 8 项要求中,3 项没有覆盖(无),1 项仅在 D 和 E 学段得到间接覆盖。未覆盖项集中在性健康内容:避孕选项(RSHE-D-03)、STI 的传播和预防(RSHE-D-05),以及色情内容和有害内容(RSHE-D-04 和 RSHE-E-02,后者为间接覆盖)。这表明中学阶段存在实质性的法定要求缺口。此外,心理健康求助要求(RSHE-E-01)虽得到部分满足,但安排在早于法定要求规定的学段,这意味着 E 学段的要求尚未得到落实。

coverage_statistics:

{
  "total_requirements": 8,
  "directly_covered": 2,
  "partially_covered": 2,
  "indirectly_covered": 1,
  "not_covered": 3
}

已知限制

主题覆盖不等于深度相当。 框架条目在 coverage_table 中被标记为与某项要求“直接”匹配,只能证明框架文档中涉及该主题;不能证明该主题的教学深度达到要求所期望的水平、评估方式符合要求的预期,或实施时达到认证机构所要求的成熟度。Webb(1997)的知识深度维度——即框架内容的认知要求是否与该要求的认知要求相匹配——不在此技能的范围内。被归类为直接匹配的 coverage_table 行,是专业审核的起点,而非结论。

在提交任何认证申请前,都必须由专业人士进行判断。 此技能旨在为课程协调员或认证审核人员的工作提供框架。覆盖分类由系统通过模式匹配框架文本生成,尚未经过相关监管领域合格专业人士的审核。在使用此输出支持认证声明之前,具备相应能力的专业人士必须审核每一项直接匹配和部分匹配,并确认按照认证机构对相关要求的解释,该匹配确实成立。此技能明确不能替代这类审核。

此技能无法评估已教授、已评估或实际实施的课程。 输入的框架描述的是预期课程——即学校文档中说明将要教授的内容。此技能是将文档与文档进行核查。它无法判断框架内容是否确实在课堂上教授、是否经过评估,或实际实施的课程是否与书面框架一致。表格中的覆盖情况仅表示文档中有所涵盖。认证机构和法定检查人员通常要求提供课程实际实施情况的证据,而不仅是课程文档;此技能仅支持文档准备阶段。

评论

支持 Markdown