Communitygithub.com

MarkitUI:构建页面

设计技能。在用户自己的 MarkitUI Figma 文件中,使用库区块构建网站或在线商店页面:页面计划以供审批、项目区块、xl 和 base 页面框架(以及可选的 md 平板框架),并为开发者添加交接备注。当用户想要设计、组合、规划或构建页面、站点地图、着陆页或商店时使用。

MarkitUI:构建页面 是什么?

此技能用于在 Figma 中将需求、站点地图或现有网站转化为完整的 MarkitUI 页面。它遵循从库区块到项目区块的严格流程,使用 Breakpoint 组件组合页面,并为每个页面生成 xl(桌面)和 base(移动)框架,可选添加 md(平板)框架,最后添加开发交接备注。技能包含完整的规划、构建和检查工作流,并参考多个内部文档(如页面规划、项目区块、响应式设计等)来确保一切与 MarkitUI 的设计系统保持一致。用户需先回答一系列初始问题(如构建来源、响应式变体、项目名称等),然后才能生成并提交页面计划供审批。该技能适用于 Claude Code、Cursor、Codex 等工具,并通过 Figma MCP 服务器与 Figma 文件交互。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/studio-coal/markitui/tree/HEAD/skills/markitui-build-pages

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

MarkitUI:构建页面 是做什么的?

将需求、站点地图、页面列表、参考网站或现有网站转化为用户 MarkitUI Figma 文件中完成的页面。流程始终如下:

库区块 → 项目区块 → 在 Breakpoint 组件中组合页面 → 为每个页面在一个 Section 中分离出 {页面} / xl 和 {页面} / base 框架(如果用户需要平板,还包括 {页面} / md)→ 交接备注。

文件自身的文档是最终依据。每次运行开始时,请阅读文档页面的 组合页面、布局 和 断点 文档框架,以及用于区块类别列表的 导航 文档框架。当网站包含博客、更新日志、客户案例或活动时,还需阅读归档组件页面的 归档页面 文档框架和博客(归档/文章)页面的 组装归档和详情页 文档框架。如果此技能中的任何内容与文件不一致,请遵循文件。

开始之前

  • 仅在用户自己的 MarkitUI 副本中工作。如果你没有其 Figma 链接,请向用户索取。
  • 写入 Figma 需要具有写入权限的 Figma MCP 服务器。在首次编辑前,加载 Figma MCP 的写入文件指南(其 figma-use 技能),如果服务器要求,先创建一个会话。
  • 每个脚本最多切换一次 Figma 页面。按名称而非 ID 查找页面、组件和变量集合。
  • 库区块和基础组件是最终版本。切勿为了适配页面而编辑它们。如果某个区块无法直接使用,请告知用户并询问。

初始问题

在任何规划之前,用 一条 消息询问用户需求中未明确说明的内容(在界面提供选项时使用选择题)。仅当需求明确回答问题时,才跳过该问题。

  1. 页面应从什么构建?

    • 商业需求或描述
    • 站点地图或页面列表
    • 要遵循的参考网站(仅结构,新文案)
    • 要重建的现有网站(保留其文案)
    • 他们拥有的其他内容:截图、文档、竞品网站、线框图
  2. 响应式变体: 每个区块和页面应该有几个断点变体?

    • xl + base(桌面和移动;默认,库区块已就绪)
    • xl + md + base(增加平板:每个项目区块中一个 md 变体,每个页面一个 md 框架)
    • 仅部分页面添加 md(他们指定页面)

    给出 references/responsive.md 中的一行权衡说明。未经确认,绝不添加 md。

  3. 项目名称,用于每个组件名称(例如 Acme)。

  4. 站点类型: 营销网站、在线商店,或两者兼有。

  5. 构建位置: 文件中的新 Figma 页面(例如 ↳ Acme 页面),除非用户指定了名称。

  6. 文案: 用户真实文案、以参考网站风格编写的文案,或可信的占位符文案。

  7. 商店相关: 国家、货币和数字格式,增值税或销售税率。

然后收集所选来源所需的内容:需求、站点地图或网站 URL(对于参考或现有网站,请阅读 references/existing-site.md)。

默认使用项目区块。仅当用户要求快速原型或单个着陆页时,才直接使用库区块。

工作流

阶段 1:页面计划(停等审批)。 阅读 references/page-planning.md。计划中需说明用户选择的断点。盘点库,为每个页面选择区块,并展示计划表格。对于博客、更新日志、客户案例或活动与网络研讨会页面,阅读 references/content-types.md,并为每个类型规划一个归档页面和一个详情模板。如果输入是待重建的现有网站,先阅读 references/existing-site.md;它会生成相同的计划。停等 审批或修改。

阶段 2:项目区块。 阅读 references/project-blocks.md。将每个选定的库区块克隆为项目区块,重命名,并在主组件中进行适配。也将导航栏、菜单和页脚构建为项目区块。对于归档区块,按 references/content-types.md 的描述,在项目区块主组件中设置归档组件(页眉、侧边栏、分页)。如果用户选择了 md,请阅读 references/responsive.md,并为 md 页面使用的每个项目区块添加 md 变体。

阶段 3:组合页面。 阅读 references/composing.md 和 references/content.md。在 Breakpoint 组件中为每个页面构建 xl 版本,复制出 base 版本(以及遵循 references/responsive.md 的 md 版本),分离,命名,放入 Section 中,并布置画布。

阶段 4:交接备注。 阅读 references/handoff.md。为每个 xl 框架添加路由注释,并在静态框架无法展示交互行为的位置添加行为和内容注释。

检查并报告。 阅读 references/checks.md。运行脚本检查,为每个页面在其所有断点下截图,修复发现的问题,然后报告。

参考文件:在相应阶段读取

  • references/page-planning.md:页面构成、选择区块、计划表格。阶段 1。
  • references/existing-site.md:重建现有网站。阶段 1,当输入为现有网站时。
  • references/content-types.md:博客、更新日志、客户案例和活动与网络研讨会的归档和详情页面;ArchiveHeader、ArchiveSidebar 和 ArchivePagination。阶段 1-3,当站点包含这些内容时。
  • references/project-blocks.md:克隆、命名、主组件中的修改内容、设计规则。阶段 2。
  • references/responsive.md:md 选项、为项目区块添加 md 变体、使用 Breakpoint 组件组装 md 页面。初始问题、阶段 2 和阶段 3,当选择 md 时。
  • references/composing.md:Breakpoint 组件、xl 和 base、分离、命名、画布布局。阶段 3。
  • references/content.md:文案、商店数据、日期、图片。阶段 3。
  • references/handoff.md:开发者及 generate-code 技能依赖的注释格式。阶段 4。
  • references/checks.md:审计、截图和报告。最后。

不可协商条款

  • 在规划之前,询问需求未回答的初始问题,包括响应式变体。
  • 在计划之后停等审批。绝不从未经批准的计划构建页面。
  • 绝不编辑库区块、基础组件或归档组件;所有修改均在项目区块或实例覆写中进行。
  • 每个页面都包含一个 xl 和一个 base 框架(如果选择 md,则还包括一个 md 框架),它们由相同的区块构建,每个区块的 Breakpoint 与其框架匹配。
  • 所有内容均使用 MarkitUI 变量和文本样式。不允许使用原始颜色、间距、圆角或字体设置。
  • 使用真实或可信的文案,绝不使用 Lorem ipsum。不使用非用户所有的真实品牌名称或标志。
  • 每个 xl 框架必须具有精确格式的路由注释,格式见 references/handoff.md。

相关技能