docs-page

文档页面技能

在一个 HTML 文件中生成单页、三栏文档页面。

工作流

1. 读取当前的 DESIGN.md（已在上方注入）。正文使用正文类型令牌；代码使用等宽字体令牌；遵循行高和最大宽度规则。
2. 从需求简介中选择一个主题——页面应像真实文档，而不是通用线框图。使用具体的 API 名称、命令示例和合理的参数。
3. 布局三个区域：
   • 左侧导航（240–280px，粘性定位）：分组链接列表，当前页面以粗体显示，并带有左侧边缘强调条。设置 3–5 个分组，每组 4–8 个链接。
   • 文章正文（最大宽度约 720px，居中显示在中间列）：H1、导语段落、H2 章节、代码块、提示框（备注／警告）、行内链接、列表。
   • 右侧目录（200–240px，粘性定位）：“本页内容”，包含 H2/H3 锚点；用户滚动时高亮当前章节。
4. 编写单个 HTML 文档：
   • 从 <!doctype html> 到 </html>，所有 CSS 均内联。
   • 使用 CSS Grid 划分三栏；两侧栏采用粘性定位。
   • 代码块使用等宽字体令牌和柔和的表面填充，并提供复制按钮样式（仅视觉效果——无需 JS）。
   • 为每个 H2/H3 添加锚点 ID，使目录链接可用。
   • 在导航、文章和目录上添加 data-od-id。
5. 正文：撰写至少 350 词可信的文档内容。至少包含一条 shell 命令、一段代码片段（5–15 行）、一个提示框和一张表格。
6. 自检：
   • 正文按照 DS 的理想行长换行（60–75 个字符）。
   • 代码使用 DS 等宽字体令牌，而非通用的 monospace。
   • 强调色使用克制——用于当前导航项、链接和一个提示框边框。不要用于正文。
   • 页面在 1280w 下易于阅读，并能在 900w 以下优雅折叠（目录隐藏，导航变为顶部抽屉）。

输出约定

在 <artifact> 标签之间输出：

<artifact identifier="docs-slug" type="text/html" title="Docs — Page Title">
<!doctype html>
<html>...</html>
</artifact>

在产物前写一个句子，产物后不写任何内容。