mcpField
H
html

html

github.com/plannotator设计与 UI3.8k3.9k 次安装2 周前更新
代码仓库

关于 html

html 是用于制作自包含 HTML 成品的技能,涵盖报告、演示文稿、界面和数据故事等;遇到更适合的结构或设计任务时,会转交给相关专门技能。

主要功能

  1. 01将请求导向专门技能
  2. 02提供文档、界面、图表和数据可视化指引
  3. 03要求内嵌 CSS 和 JavaScript
  4. 04强调响应式与无障碍交互
  5. 05检查成品并进行原创性审视

适用场景

  1. 01制作 HTML 报告或说明文档
  2. 02构建交互流程或界面原型
  3. 03创建图表或数据故事
  4. 04制作演示文稿或落地页

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/plannotator/effective-html --skill html

安装后在 Claude Code 中输入/html确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
charts-and-data.md
creative-direction.md
diagrams.md
documents-and-presentations.md
interfaces.md

详细介绍

HTML

构建一个独立的 HTML 文件,让主题更清晰、更易使用或更易理解。标准是始终用心,而不是始终采用相同的外观。不要复刻以往运行中使用的固定配色、字体组合、卡片系统或布局。

先为请求确定方向

针对主要评审问题,选择最合适的技能:

  • 如果配色、字体、构图、主题风格或整体视觉基调尚未确定,请阅读并结合 design-artifact 与选定的工作流。它负责提供创意方向;但不能取代负责保真度、结构或行为的专门技能。
  • 如果结构、信息层级、导航或任务流程尚未确定,请阅读并遵循 html-wireframe。它应保持明显的低保真状态,并可比较两到三种布局方向。
  • 如果用户需要精致的模型稿或可交互的工作流程,请阅读并遵循 html-prototype。模型稿是该技能中的静态保真模式。
  • 如果产物主要是计划、路线图、实施顺序或推出文档,且需要便于核实来源中的承诺,请阅读并遵循 html-plan。
  • 如果关系、顺序、拓扑、状态、层级或系统行为是主要内容,请阅读并遵循 html-diagram。
  • 对于报告、说明文、演示文稿、落地页、数据故事、工具,以及没有更明确归属的混合型产物,请继续使用 html。

如果这些技能所在的集合一并安装,上述同级链接就是嵌套机制。如果无法使用某项专门技能,请继续使用此处的技能,并加载最接近的参考资料。完成请求前,不要要求用户安装其他技能。

设计前先了解情况

检查用户的请求和提供的材料。如果在代码库中工作,请从 AGENTS.md、CLAUDE.md、设计系统文档、设计令牌、现有组件和相邻产物中了解其设计语言。

按以下顺序确定优先级:

  1. 用户明确提出的视觉和功能要求。
  2. 项目既有的设计系统和惯例。
  3. 产物的主题、受众和用途。
  4. 你自己的设计判断。

编码前,在工作笔记中确定以下五项:

  • 受众和目标: 谁会使用它?他们应该理解什么或采取什么行动?
  • 形式: 文档、演示文稿、界面、图表还是数据可视化。
  • 风格基调: 沉静务实、精致且具编辑感,还是刻意鲜明。
  • 保真度: 是保留用户的结构和措辞,还是更自由地综合创作。
  • 交互: 是否需要通过探索、排序、筛选或动态效果来提升体验?

如果项目已对视觉问题作出规定,请遵循这些规定。否则,如果 design-artifact 可用,请阅读并结合使用。如果安装的集合中没有该同级技能,请先阅读 references/creative-direction.md,再选择配色、字体、构图或动态效果。

只加载产物所需的指导

请求可能涉及多种形式。阅读所有实质相关的参考资料,然后为产物确定统一的方向。

构建要求

  • 生成一个 .html 文件,并将必要的 CSS 和 JavaScript 内嵌其中。文件应可直接打开,无需构建步骤。除非用户允许使用外部依赖,否则不要要求联网。
  • 使用真实内容。不要用占位文案、装饰性统计数据或不起作用的控件填充显眼区域。
  • 根据内容决定结构。序列应按顺序呈现;比较应便于浏览差异;界面应展示状态和操作;图表应清晰呈现关系。
  • 使用语义化 HTML、响应式布局、无障碍对比度、清晰可见的键盘焦点,并支持减少动态效果设置。交互元素应支持键盘操作。
  • 避免页面主体出现意外的水平溢出。将有意设置为宽幅的内容放入带有滚动或平移功能的容器中。
  • 为选定的设计方向定义一小组 CSS 令牌,并保持一致使用。令牌是实现工具,不是预设的配色方案。
  • 将动态效果用于解释或反馈。如果移除动画不会损失任何含义或实用反馈,就移除它。
  • 遵循用户或项目的主题策略。如果没有相关策略,且有助于使用,请考虑为耐用实用型作品提供浅色和深色主题。有意采用单一主题也可以。

完成工作

将文件写入指定位置,或在当前工作区中选择一个明确的文件名。如果有浏览器工具,请打开文件并检查宽、窄视口。操作各项控件,检查控制台,并修复裁切、重叠、文字难以辨认、状态异常和意外溢出等问题。

交付前进行一次原创性检查:如果将主题替换为相近主题,同样的视觉概念是否依然恰如其分?如果是,说明设计方向过于通用;请调整构图、字体、颜色、图像或交互方式,使其更贴合当前主题。

返回绝对路径,并简要描述作品的视觉设计和交互选择。

评论

支持 Markdown