Skip to content

docs: 整理 dimensional-drawing 的组件尺寸图约定 - #4

Merged
Owlbay merged 2 commits into
mainfrom
cursor/dimensional-drawing-notes-2956
Oct 28, 2026
Merged

Owlbay merged 2 commits into
mainfrom
cursor/dimensional-drawing-notes-2956

Conversation

@Owlbay

@Owlbay Owlbay commented Oct 28, 2026 •

Copy link
Copy Markdown
Owner

整理了什么

enesozturk/dimensional-drawing(MIT)是两个 agent skill:把 UI 组件画成一页苹果配件图风格的尺寸图,以及把画完的图做成约 10 秒短片。

本 PR 只整理对做界面的 agent 有用、并且能和现有规范接上的约定:

  • 只画结构(槽位、HUG / FLEX / FILL),不画文案
  • 图上用代号,表里写名称、公式和实测值
  • 源码或已发布规格里没有的量标 [TBD],不发明数值
  • 测量走真实盒模型,并以整套组件系统为准
  • 一页图纸的信息架构,以及交付前能核对的闭合条件
  • 短片只保留时间结构:纯时间函数、笔画先于填充、8–15 秒

代号和本仓库的间距 token、Quiet 的嵌套圆角对齐:能对应上就写 token 名,边框为 0 时内圆角公式与 Quiet 的「外 = 内 + 内距」相同。

未复制上游的 HTML 示例、SVG 绘图工具、动效场景、渲染器和媒体文件。许可证与来源写在文档开头,并在 THIRD_PARTY_NOTICES.md 登记为「参考整理,未同步进 vendor/」。

放在哪里

  • 文档:docs/references/design/dimensional-drawing.md
  • 索引:docs/README.md。docs/ 是基准仓库自己的文档;references/ 放外部资料的约定摘要,下面按主题分目录(现在有 design/)。以后新增资料放到对应主题,没有合适主题就新建目录,并登记到这份索引。
  • 根 README.md 的收录表、目录树和约定已改到这条路径。
  • 许可证:THIRD_PARTY_NOTICES.md

为什么这么组织

  • vendor/ 由 scripts/sync-upstream.py 原样同步可安装的 skill。这份材料要连同示例和渲染器才完整,同步进来等于收下一套绘图程序;skill 文本本身也要求从上游示例改起。需要出图时按文档从上游安装。
  • project/docs/design/ 是新产品要遵守的界面风格,会被 new-project.sh 拷进每个项目。尺寸图是按需产出的说明文件,单色、无品牌,和 Quiet / Terminal 不是同一套规则。
  • 因此放在基准仓库的 docs/references/design/:不进项目模板,也不同步源码。references/ 与可安装的 vendor/ 分开,design/ 把界面和图纸类资料归在一起,以后继续按主题加,而不是平铺在 docs/ 根目录。
Open in Web Open in Cursor 

cursoragent and others added 2 commits October 28, 2026 06:51
上游是 MIT 的 agent skill,用来把 UI 组件画成一页尺寸图。
本仓库只收可复用约定:结构代替文案、代号和公式、不发明数值、
测量走真实盒模型。不把绘图套件和动效渲染器同步进 vendor/,
也不放进会被拷进每个新项目的 project/ 模板。

Co-authored-by: Owlbay <gzh298255@gmail.com>
组件尺寸图从 docs/ 根目录挪到 docs/references/design/,
并加 docs/README.md 说明各子目录放什么、以后如何继续收录。

Co-authored-by: Owlbay <gzh298255@gmail.com>
@Owlbay
Owlbay merged commit db602cc into main Oct 28, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants