用途:为 Docker Labspace 生成 Hugo 指南页面。输入为 dockersamples 组织下的仓库名(如 labspace-ai-fundamentals)。
主要能力:
- 克隆仓库:git clone --depth 1 https://github.com/dockersamples/{REPO_NAME}.git "$TMPDIR/{REPO_NAME}"
- 从 README.md、labspace/labspace.yaml、labspace 下模块内容、.github/workflows/*.yml、compose.override.yaml 提取信息,包括简介、学习目标、是否需下载模型、已发布的 Compose 文件 URL。
- 生成指南文件 content/guides/lab-{GUIDE_ID}.md,含 frontmatter(title、linkTitle、description、summary、keywords、aliases、params.tags、time、resource_links)与正文段落、Launch the lab、What you'll learn、Modules 表格。
必要用法与规则:
- 所有指南的 params.tags 必须含 labs。
- AI 相关 Lab 需加 ai 标签,并添加 /labs/docker-for-ai/ 下的 alias。
- 若需下载模型,在 labspace-launch shortcode 加 model-download: true。
- 遵循 Docker 文档风格:用祈使句或 you,避免 we/let's、simply/easily/just、allows you to、click、currently/new/recently;bold 仅用于 UI 元素;shell 代码块用 console 语言提示。
验证步骤:检查 frontmatter 含 title、description、keywords 及 params.tags(含 labs);运行 npx --no-install rumdl fmt <file>;运行 docker buildx bake lint vale 并修复错误;复核 shortcode 语法、目标与模块是否匹配 labspace.yaml。验证通过前不要提交。
适用场景:维护 Docker 文档中 Labspace 指南页时使用。限制:仅适用于 dockersamples 组织的 Labspace 仓库;价格、平台等未在资料中说明。