跳转到使用指南
Component Canvas作者 ibelick

Component Canvas Skill.

在可平移缩放的画布上检查真实 UI 组件及其变体。

  • 组件变体
  • 对比
源文件解读 · component-canvasSKILL.md
任务 在可平移缩放的画布上检查真实 UI 组件及其变体。 产出 包含所需组件的独立画布路由或入口。 开始前的准备 不能为了让预览正常而修改组件源代码、hook 或样式。
编辑摘要 · 源文件核查于 2026-11-02 · 非生成示例

01 功能说明

在可平移缩放的画布上检查真实 UI 组件及其变体

为现有组件建立独立画布,对比受支持的变体,同时保留真实键盘、portal 和输入行为。

基于来源的工作流并非执行基准测试

工作方法

Component Canvas 为项目中已有的组件创建全屏检查界面。它将受支持的变体和有用状态分组,让设计师一眼对比并操作真实控件。源文件要求组件实现独立于画布。

这套工作流对“对比”有明确要求:比较尺寸时,文字、样式和数据保持不变;比较样式时,只改变样式。它也保留原生 portal、焦点和嵌套滚动行为,因此有用的预览不能只在默认状态截图中看起来正常。

预期交付物

  • 包含所需组件的独立画布路由或入口。
  • 具名变体分组,以及记录的覆盖清单和省略情况说明。
  • 关于修改文件、已执行检查、决策和未测试行为的报告。
查看示例简报

从简报到审查

  1. 01
    先挂载一个安全示例

    阅读组件公开 API 和项目约定。先用测试数据、mock 或现有回调防止真实写入,再挂载单个组件。

  2. 02
    建立可比较的分组

    按一致方式加入受支持的变体,每次只改变一个比较维度,并保留组件真实的禁用、聚焦和交互行为。

  3. 03
    验证组件外围的画布

    测试平移、缩放、适配视图和键盘导航,同时检查嵌套滚动及原生 portal 行为。只持久化视角,并确认重置不会清除预览状态。

02 适用场景

适合什么场景

不能为了让预览正常而修改组件源代码、hook 或样式。

适合的场景

  • 检查组件变体通过真实公开 API 对比按钮、输入框等现有组件。
  • 评审组件让设计师在不改动生产实现的情况下体验受支持的状态。

需要检查的限制

  • 组件实现保持只读不能为了让预览正常而修改组件源代码、hook 或样式。
  • 受限的工作空间分组不能拖动,画布不提供编辑历史或撤销/重做。
  • 安全测试数据如果无法安全隔离生产调用和写入,就省略相应的可交互示例。

请提供这些输入

  • 组件范围指定要包含的组件和公开变体。
  • 测试环境为交互示例提供安全的数据、provider 和回调。
  • 项目约定使用现有路由、主题 API、依赖和访问控制。

03 关键决策

影响结果的关键选择

  1. 真实行为

    示例通过原生指针和键盘交互响应。

  2. 公平对比

    保持其他属性不变,才能看出某个变体实际改变了什么。

  3. 实现范围清晰

    视角和布局逻辑与组件源代码保持分离。

04 示例任务

从一份具体的需求开始

以下示例任务说明尚未经过测试。使用前请检查该技能的设置。

查看源文件和环境要求

指定要包含的组件和公开变体。

上游源文件
https://github.com/ibelick/ui-skills/blob/4907a526b07943b3a338177558d42fae4fdf0a86/skills/component-canvas/SKILL.md

下方链接会打开上游使用说明。使用前请查看仓库的环境配置要求;这不是安装命令。

先完成一项明确的交付物

运行该技能之前,请根据需要调整此需求中的范围、来源材料和约束。

示例简报
使用 component-canvas,检查我们现有的 Button、Select 和 Dialog 组件。阅读公开 API,用测试数据展示受支持的具名变体。每次只比较一个属性,标签和其他设置保持一致。不修改组件源代码,使用当前主题 provider。先完成一个安全示例,再添加其余分组。在多个缩放级别验证键盘输入、焦点、嵌套滚动和 portal 位置。报告省略的情况,以及因缺少设备而无法执行的检查。

检查结果

根据以下可观察标准检查实际输出。

  • 组件源代码没有差异,测试数据不会触发真实写入。
  • 缩放时 portal 对齐、焦点和原生输入仍然可用。
  • 重新加载后恢复视角位置;重置保留当前预览状态。不保证重新加载后保留预览草稿,存储失败时应安全回退。

OpenDesign 为编码智能体提供本地设计工作区。此条目并不表示该技能已内置,也不表示其中包含其外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定来源修订版本。上游行为和要求可能会发生变化。

来源所有者
ibelick
技能文件
SKILL.md
许可证
MIT
已审查的快照
2026-11-02 · 4907a526b079
编辑来源摘要
在可平移缩放的画布上检查真实 UI 组件及其变体。

由 OpenDesign 根据所链接来源撰写的原创摘要。仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前可能想问

可以拖动组件分组吗?

源文件明确要求分组固定。平移和缩放改变的是视角。

它会自行补出缺失的组件变体吗?

不会。它读取公开 API 并列明省略情况,不会修改组件来模拟不具备的支持。

重新加载后保留什么?

规定的持久化只保存视角。除非另有要求,预览草稿无需在重新加载后保留。

OpenDesign

让需求和设计工作保存在一起。

将简报、来源材料和设计工作集中保存在本地工作区中。将该技能添加到工作流程前,请检查其自身的设置说明。

上游源文件
https://github.com/ibelick/ui-skills/blob/4907a526b07943b3a338177558d42fae4fdf0a86/skills/component-canvas/SKILL.md