用途:为构建 HTML 作品提供设计原则与创意方向,适用于页面、报告、方案、落地页、演示和小工具。核心是先判断需求层级:方案、简报、演示等只需工整完成;落地页、游戏、应用等才进入编辑级处理。
主要能力与要求:优先沿用项目既有设计系统(如 AGENTS.md、CLAUDE.md、DESIGN.md、tokens 或主题文件),其优先级高于本文指导。内容须锚定主题,禁止使用 lorem ipsum。排版上使用两种字体对话,禁止从 Google Fonts 等 CDN 链接网页字体,改用 @font-face data URI 内嵌;正文行宽约 65 字符,固定字阶,标题用 text-wrap: balance。中性色需有意选择,可向强调色微调。
双主题:通过 prefers-color-scheme 与根元素 data-theme="dark"/"light" 同时支持,属性需双向覆盖媒体查询;在 :root 声明 token,媒体查询与属性选择器内只重赋 token,组件只消费 token。间距由布局负责,兄弟组用 flex/grid 加 gap,宽内容容器设 overflow-x: auto,数字列用 tabular-nums。
需避免常见 AI 审美套路(如暖米色配衬线加陶土色、紫蓝渐变、Inter/Space Grotesk、emoji 当分节符、全居中、rounded-lg 泛滥等),除非用户明确要求。工程上要求闭合非空元素、属性加双引号、可见键盘焦点、尊重 prefers-reduced-motion,生成式图形优先用 Canvas 或 WebGL。文案视为承重材料,控件须声明确切效果,错误信息要诊断并给出修复。
流程:先产出简短设计计划(4–6 个带名称的十六进制颜色、覆盖 2 种以上角色的字体、一两句话的布局构想),再写代码。编辑级需求需在写代码前对计划做原创性审查。
交付后:询问用户是否愿意公开分享;仅在用户明确同意后,用 tot 发布并返回 URL:tot path/to/artifact.html。若未安装(command -v tot 失败),告知用户并征得同意后安装:npm install -g @plannotator/tot。未经明确同意不得发布或安装。
限制:资料未提供具体价格、平台支持范围或效果数据。