用途:该技能专注于 Docusaurus 站点的构建健康、MDX 校验与部署安全,用于在提交前发现并阻止常见构建失败,而非通用 DevOps、Kubernetes、运行时监控、数据库迁移或安全扫描。
主要能力:识别五类反复出现的问题——示例中的 Liquid 模板语法破坏 MDX、未转义尖括号(如 <70 被当作 HTML)、SkillHeader 组件属性错误(应使用 fileName 而非 skillId)、缺失关键文件(hero 图片、ZIP、未加入 skills.ts)、缓存损坏导致的假错误。提供提交前钩子与手动校验脚本。
使用方式:一次性安装钩子 npm run install-hooks;手动校验可运行 npm run validate:liquid、npm run validate:brackets、npm run validate:props、npm run validate:all;缓存异常时执行 rm -rf .docusaurus build node_modules/.cache 后 npm run build。提交前钩子会自动扫描代码块之外的 Liquid 双花括号、<数字 模式、SkillHeader 用法及必需文件,典型提交耗时低于 5 秒。
适用场景:Markdown/MDX 提交前校验、Liquid 语法错误排查、SkillHeader 属性校验、缺失 hero 图片或 ZIP 检查、构建前链接校验、构建后健康报告、Docusaurus 构建失败诊断。
限制与说明:不适用于通用 DevOps、Kubernetes/云基础设施、运行时监控告警、数据库迁移与安全扫描。校验脚本位于 scripts/ 目录(validate-liquid.js、validate-brackets.js、validate-skill-props.js),参考文件包括 references/validation-logic.md 与 references/ci-cd-integration.md。资料中提及的成功指标(构建失败率 15% 降至 2% 以下等)为原文陈述,实际效果暂未提供独立验证。具体平台、收费与价格信息暂未提供。