技能 编程开发 生成专业技术文档页面

生成专业技术文档页面

v20260430
docs-page
当需要撰写技术文档、用户指南或API参考时使用。本技能将生成一个结构完善的HTML页面,采用三栏布局,包括左侧导航、中央主体文章区和右侧固定目录。它能确保技术内容展示专业、易读且高度可导航。
获取技能
204 次下载
概览

Docs Page Skill

Produce a single, three-column documentation page in one HTML file.

Workflow

  1. Read the active DESIGN.md (injected above). Use the body type token for

prose; the mono token for code; respect line-height and max-width rules.

  1. Pick a topic from the brief — the page should look like real docs, not

a generic wireframe. Concrete API names, command examples, plausible
parameters.

  1. Lay out three regions:
  • Left nav (240–280px, sticky): grouped link list, current page bolded

with a left-edge accent stripe. 3–5 groups of 4–8 links.

  • Article body (max-width ~720px, centered in the middle column):

H1, lede paragraph, H2 sections, code blocks, callout boxes (note /
warning), inline links, lists.

  • Right TOC (200–240px, sticky): "On this page" with the H2/H3

anchors, current section highlighted as the user scrolls.

  1. Write a single HTML document:
  • <!doctype html> through </html>, all CSS inline.
  • CSS Grid for the three columns; sticky positioning for the rails.
  • Code blocks: monospace token, soft surface fill, copy-button affordance

(visual only — no JS needed).

  • Anchor IDs on every H2/H3 so the TOC links work.
  • data-od-id on the nav, article, and TOC.
  1. Prose: write at least 350 words of believable docs. Include at least

one shell command, one code snippet (5–15 lines), one callout, one table.

  1. Self-check:
  • Body text wraps at the DS line-length sweet spot (60–75 chars).
  • Code uses the DS mono token, not generic monospace.
  • Accent is restrained — used for active nav item, links, one callout

border. Not on body text.

  • Page is readable at 1280w and collapses gracefully below 900w (TOC drops

out, nav becomes a top drawer).

Output contract

Emit between <artifact> tags:

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

One sentence before the artifact, nothing after.

信息
分类 编程开发
名称 docs-page
版本 v20260430
大小 3.91KB
更新时间 2026-05-01
语言