SuperAPI AI 工具集

fact-check

编程与开发

查看项目

更新于 10-16 08:23

技能介绍

用途

该技能用于验证「33 JavaScript Concepts」项目中概念文档页面的技术准确性,确保不传播关于 JavaScript 的错误信息。

主要能力

技能围绕五个阶段的事实核查方法展开:

  1. 代码示例验证:识别文档中所有代码块,逐一核对代码输出与注释是否一致,检查变量命名与逻辑,验证标记为错误(❌)的示例确实产生错误行为,标记为正确(✓)的示例符合当前最佳实践。同时运行项目测试(npm test)并检查测试覆盖率。

  2. MDN 文档验证:检查所有 MDN 链接是否返回 200、是否指向正确页面,核对方法签名、参数、返回类型、副作用、异常和浏览器兼容性,标记已废弃的 API。

  3. ECMAScript 规范合规性:针对边界情况、类型强制转换、运算符优先级、执行顺序等细微行为,对照 ECMAScript 规范(https://tc39.es/ecma262/)进行验证。

  4. 外部资源验证:检查外部链接的可访问性、内容准确性、发布时间和描述匹配度,识别过时内容、反模式或非 JavaScript 主题的资源。

  5. 技术论断审计:审查所有关于 JavaScript 行为的文字论断,识别缺少例外的「总是/从不」表述、无基准的性能声明、未指明浏览器的行为声明等。

使用方式

技能提供了详细的核查清单、常见输出错误示例、MDN 链接模式、规范章节对照表、外部资源红旗标志、常见 JavaScript 误解对照表,以及事实核查报告模板。使用时按五个阶段依次执行,并运行项目测试套件:

# 运行所有测试
npm test

# 运行特定概念的测试
npm test -- tests/fundamentals/call-stack/
npm test -- tests/fundamentals/primitive-types/

测试目录结构按类别组织,如 tests/fundamentals/、tests/functions-execution/、tests/web-platform/。

适用场景

  • 发布新概念页之前
  • 对现有内容进行重大编辑之后
  • 审查社区贡献时
  • 使用新 JavaScript 特性更新页面时
  • 对现有内容进行定期准确性审计

限制

该技能主要针对「33 JavaScript Concepts」项目的文档页面,核查范围限于 JavaScript 技术准确性。资料中未提供关于收费、价格、平台支持范围或具体效果保证的信息。