用途: 该仓库维护说明面向需要定期维护 Web 标准与兼容性数据相关项目的开发者,列出了一组应“有规律地”执行的例行检查与更新操作。
主要能力与工作流程:
- 内嵌依赖检查:提供命令对比上游包版本与仓库内嵌版本,示例为 @vercel/detect-agent。命令会输出上游最新版本,并从 src/cli/telemetry/detect-agent.ts 中提取已内嵌的版本号。若存在更新,需要把变更同步到该文件、更新版本注释,并运行 src/cli/telemetry/detect-agent.test.ts 与 src/cli/telemetry/clearcut-logger.test.ts 两个测试文件。
- Web 特性数据集更新:web-features 的更新通过 .github/workflows/update-web-features.yml 自动化,每周一和周四运行;也可手动执行 pnpm update web-features,随后运行 src/ci/generate-feature-to-groups.ts 和 src/ci/validate-after-web-feature-update.ts。
- 兼容性数据集更新:建议定期升级 @mdn/browser-compat-data、@webref/css、@webref/elements、@webref/idl、caniuse-lite 与 mdn-data。
- 文档一致性与链接完整性:通过运行 node .agents/skills/coherence-auditor/scripts/coherence-audit.ts 执行一致性审计。
使用方式: 按页面给出的命令逐项执行,先检查版本差异,再手动或借助工作流更新数据,最后运行对应的生成、校验和审计脚本。
适用场景: 适用于维护 Web 平台特性、浏览器兼容性数据和文档质量的仓库,尤其是依赖自动更新工作流与内嵌第三方代码的项目。
限制: 页面未说明这些操作的前置环境要求、失败处理方式、更新频率以外的调度细节,也未提供 npm、pnpm、node 版本要求;具体执行效果与兼容性暂未提供。