用途:该技能用于 InfluxData docs-v2 项目的 Hugo 模板开发,核心是强制在模板改动时同时进行构建验证与运行时测试,因为仅通过构建并不能证明运行时行为正确。
主要能力与要求:按改动类型给出所需证据。修改模板或 partial 时,需要 Hugo 构建加运行时 Cypress 覆盖,并加载 references/runtime-testing.md;涉及产品特定行为时,需使用数据驱动的产品上下文,不得使用魔法值,并加载 references/product-data.md;新增 shortcode 时,需要示例页面、文档以及 Cypress 行为测试,并加载 references/shortcodes.md。
使用方式:先检查邻近的既有模式与页面级联(page cascade)。当 data/products.yml 与产品上下文 partial 已提供事实时,禁止基于硬编码的产品名称、版本或 URL 片段进行分支判断。仅在对应条件成立时加载该路由专属的参考文档。必要命令保持原样:npx hugo --quiet 与 node cypress/support/run-e2e-specs.js <content-file>。
适用场景:适用于 docs-v2 中模板、partial、shortcode 及产品特定行为的开发与修改。
限制:资料未提供更多关于环境配置、依赖版本、测试覆盖范围或失败处理方式的细节。