关于 hugo-template-dev
面向 Hugo 模板开发的技能,说明模板修改、产品特定行为和新增 shortcode 所需的检查与参考资料。它强调先查看现有模式,并在构建之外验证运行时行为。
主要功能
- 01按变更类型规定验证依据
- 02运行时 Cypress 测试指引
- 03数据驱动的产品上下文
- 04Shortcode 文档与测试要求
适用场景
- 01修改 Hugo 模板或 partial
- 02实现产品特定的模板行为
- 03新增 shortcode 并补充测试和文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ influxdata/ docs-v2 --skill hugo-template-dev安装后在 Claude Code 中输入/hugo-template-dev确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/product-data.mdruntime-testing.mdshortcodes.md详细介绍
Hugo 模板开发
| 变更 | 必需的证据 | 加载 |
|---|---|---|
| 模板或 partial | Hugo 构建以及运行时 Cypress 覆盖 | references/runtime-testing.md |
| 特定产品的行为 | 数据驱动的产品上下文,不使用魔法值 | references/product-data.md |
| 新 shortcode | 示例页面、文档和 Cypress 行为测试 | references/shortcodes.md |
前置要求:检查附近的模式和页面级联。当 data/products.yml 和产品上下文 partial 已提供相关信息时,切勿根据硬编码的产品名称、版本或 URL 路径段进行分支判断。构建成功并不能证明运行时行为正常。
npx hugo --quiet
node cypress/support/run-e2e-specs.js <content-file>
仅在适用时加载特定路由的参考文档。
评论
支持 Markdown