SuperAPI AI 工具集

sync-small-superblocks

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:审计 freeCodeCamp 课程中大型 v9 超级块与其派生的独立“small”超级块之间的漂移。当大超级块模块新增、移动或移除区块后,对应 small 超级块常未更新,此技能用于找出这些不同步之处。

主要能力:运行捆绑的检测脚本 check_sync.py,输出 JSON 格式的 findings,列出每个不同步的 small 超级块,包括来源超级块与模块、当前与建议的区块列表、缺失区块(含应插入位置、模块、intro 内容及是否已存在)、过期区块(状态为 moved 或 removed、去向、intro 是否存在),以及 ambiguous_mapping 标记(一个模块对应多个 small 超级块时需人工复核)。追加的 cert-project labs 不会被报告为过期。

使用方式:在 freeCodeCamp/freeCodeCamp 仓库根目录(含 curriculum/ 与 client/)运行,需先确认处于最新 main 分支,使用 git rev-parse --abbrev-ref HEAD 检查并拉取最新 main。需要 Python 3。从仓库根目录执行:python3 path/to/this/skill/check_sync.py,可用 FCC_REPO 覆盖工作目录。可传入超级块名称参数只报告该块,无参数则报告全部不同步项。

输出:报告检查的分支/提交、不同步总数,每个 finding 一节,列出需新增、移动或移除的区块,并指出需编辑的两个文件:curriculum/structure/superblocks/<name>.json 与 client/i18n/locales/english/intro.json。

限制:仅报告,不修改文件、不开 issue 或 PR;必须基于最新 main,陈旧或 PR 分支结果不准确;不得编造 intro 文本,应原样使用检测器返回的 intro_content,null 条目需标记人工复核;不要重复标记检测器已排除的 cert-project labs。