SuperAPI AI 工具集

wireframes

设计与创作

查看项目

更新于 10-15 10:14

技能介绍

用途

该技能把已批准的简报转化为灰色、结构化的线框图——方框、条块、形状——让用户能在投入视觉设计之前验证页面结构(区块顺序、层级、密度、空间关系)。此阶段是可选的;如果用户已有清晰的结构设想,可以直接跳到 /stardust:prototype。

何时使用

  • 用户希望在视觉设计之前验证页面结构——区块顺序、层级、密度、空间关系。
  • 用户要求为线框图添加注释,或标记跨页面可复用的片段。
  • 用户要求更改、细化、审查、评审或迭代 stardust/wireframes/**/*.html 下的任何文件。
  • 用户输入 /stardust:wireframes。

何时不要使用

  • 用于品牌视觉设计、颜色、字体或最终比例时,应交给 prototype。
  • 用于页面文案或意图时,应交给 briefings。
  • 当用户明确希望直接跳到品牌化设计时,建议改用 /stardust:prototype。

前置检查

先运行 ../_shared/preflight.md 中的流程。

契约

需要(若存在则读取):

  • stardust/briefings/{page}.md(一个或多个)
  • .impeccable.md(注释的语气)

产出:

  • stardust/wireframes/{page}.html(灰色、带注释)

若缺失:

  • 没有简报 → 提示用户给出一行页面意图,合成一份最小简报,在简报和线框图上都标注来源,然后继续。
  • 没有 .impeccable.md → 注释使用中性技术语气。
  • 此阶段有意不读取品牌。

阶段 1:规划

对每个有已批准简报的页面:

  1. 从 stardust/briefings/{page}.md 读取页面简报。
  2. 若存在,从 stardust/briefings/_site.md 读取站点简报(包括 Content Reuse Map)。
  3. 规划页面的区块——UX 探索:
    • 若安装了 impeccable 插件(/impeccable shape 已注册),将区块规划委托给 /impeccable shape。
    • 否则,使用 ../_shared/fallback-brainstorm.md 中的 “For wireframe section planning” 模式。根据 ../_shared/soft-deps.md,impeccable 回退静默运行。
    • 两条路径都要回答:这个页面需要哪些区块、视觉层级是什么、用户如何流经内容。
    • /shape 会产出一份设计简报——将其作为结构规划。
  4. 对于多页面站点,在逐个页面画线框图之前,先规划所有页面的信息架构:
    • 若本会话中 /write-plan 已注册(按 ../_shared/soft-deps.md 检测):将 IA 规划委托给 /write-plan,以站点简报和页面列表作为输入。使用其输出作为多页面结构规划。
    • 否则(未安装 superpowers):按 ../_shared/soft-deps.md 中的原文(“superpowers announcement”)每会话仅宣布一次回退——除非本会话早前已宣布过。然后内联草拟 IA:列出页面、各自主内容类型以及它们之间共享的区块,并在继续前与用户确认。

阶段 2:渲染(灰色模式)

将每个线框图渲染为灰色模式的视觉 HTML:

  • 纯灰色布局:方框、条块、形状。无品牌色,无真实字体(system-ui 即可)。
  • 背景:浅灰(#f5f5f5);元素使用不同深浅的灰色。
  • 占位文本用灰色条块;图片用带标签的灰色矩形。
  • 注释是必需的——每个块都配一个简短的斜体 .note 或 .caption,说明它代表什么,以便评审者无需猜测即可评估流程。重复项(流水线节点、主机磁贴、卡片网格)带有可识别标签(“01 · brand”、“Claude Code”),而非通用编号。参见 wireframe-guide.md 的 Annotations 部分。
  • 展示:区块顺序、相对尺寸、内容密度、空间关系。
  • 每个区块带有 data-section、data-intent、data-layout 属性,以便设计阶段能接续该结构。
  • 对于多页面站点:为可复用内容区块添加 data-fragment、data-fragment-role 和 data-fragment-source 属性——参见 wireframe-guide.md 的 Content Reuse & Fragments 部分。
  • 包含链接到简报的 JSON 元数据块(多页面站点带 fragments map)。
  • 写入 stardust/wireframes/{page}.html。
  • 若上游简报是合成的(存在来源注释,或在本前置检查期间生成),按 ../_shared/skill-contract.md 在线框图上保留来源块。
  • 遵循 wireframe-guide.md 中的完整渲染规则。

阶段 3:打开

线框图是自包含的 HTML 文件。按 ../_shared/skill-contract.md 的 Opening HTML artifacts,写入后立即在设计者的默认浏览器中打开每个文件。在 macOS 上:open stardust/wireframes/{page}.html。不要依赖设计者手动打开。

若本阶段渲染了多个线框图(多页面运行),逐个打开,以便设计者在标签页中审阅。

在流水线自动化模式(无设计者在场)下,跳过打开。

阶段 4:批准关卡

软关卡——用户批准的是结构,而非视觉。

展示线框图并询问:“这个结构符合你的设想吗?需要改什么?”

常见反馈:

  • “交换这些区块” → 重新排序,重新渲染。
  • “为 [X] 添加一个区块” → 添加带数据属性的新区块,重新渲染。
  • “这个区块相对其他太大/太小” → 调整比例,重新渲染。
  • “我想在这里加点可交互的东西” → 添加 data-interactive 属性。

迭代直到用户批准。然后:

  • 若 stardust/brand-profile.json 存在:“线框图已批准。运行 /stardust:prototype 将它们升级为品牌化原型。”
  • 若不存在:“线框图已批准。运行 /stardust:brand 捕获你的品牌,然后运行 /stardust:prototype 将其叠加到这些线框图上。”

流水线自动化:当作为完整流水线运行的一部分被调用时,自动批准并继续。

为什么先线框图后设计

线框图让你在不被视觉决策(什么颜色、字体和比例)干扰的情况下做出结构决策(什么放在哪里、以什么顺序、以什么相对尺寸)。将两者分开意味着每个决策都能得到充分关注。

已经知道结构的用户完全可以跳过此阶段,直接走 briefings → design。

产出的工件

文件 | 描述

stardust/wireframes/{page}.html | 灰色结构线框图——自包含 HTML