design-md

design-md 技能概览

design-md 的作用

design-md 技能会把 Stitch 项目转换成一个 DESIGN.md，用文字提炼出屏幕背后的语义化设计系统。它面向的是需要可提示、可复用的设计事实来源，而不只是做一份视觉检查报告的人。如果你在用 Stitch 生成新页面，并希望布局、语气、颜色和组件语言保持一致，design-md 就是为这个场景设计的。

适合谁使用

如果你正在处理一个带有真实界面的 Stitch 项目，并希望用一种可重复的方法把设计系统写成文字，就适合使用 design-md 技能。它特别适合产品设计师、使用 AI 辅助构建前端的人，以及需要把现有 UI 文档化、让 Stitch 继续生成风格一致新界面的团队。

这项技能为什么不一样

design-md 的核心价值在于“翻译”：它会读取技术层面的设计信号，并把它们转成自然、可复用的设计指引。之所以重要，是因为 Stitch 最擅长响应有具体数值支撑的描述性设计语言，而不是空泛的风格标签。它尤其适合在你需要的是一份能指导后续生成的 DESIGN.md，而不是对当前屏幕做一次性总结的时候。

如何使用 design-md 技能

在 Stitch 工作流中安装该技能

使用 npx skills add google-labs-code/stitch-skills --skill design-md --global 安装 design-md。仓库路径是 google-labs-code/stitch-skills，该技能位于 skills/design-md 下。如果你的环境不是全局安装，就按你本地的 skills 工作流调整安装方式。

提供正确的起始上下文

想让 design-md usage 效果最好，起点要足够清晰：Stitch 的目标项目名或 ID、要分析的屏幕或流程，以及你希望生成的 DESIGN.md 用来支持什么。好的提示会明确你要文档化什么、为什么文档化，例如：“分析我的 Furniture Collection 项目的 Home 屏幕，生成一份可以指导新商品列表页的 DESIGN.md。”这比泛泛地要求“总结一下设计”更有效，因为它告诉技能该优化什么。

先读这些文件

如果你想要一份实用的 design-md guide，先看 SKILL.md 了解工作流，再看 README.md 了解安装和示例用法，最后检查 examples/DESIGN.md，看预期输出长什么样、细节粒度到什么程度。如果你在判断这项技能是否适合你的仓库或流程，这三个文件能最快给你明确判断信号。

能提升输出质量的工作流

最好在你已经有至少一个设计好的 Stitch 屏幕可供分析时再使用这项技能。它依赖项目检索和设计元数据，所以当输入包含真实项目、明确屏幕，以及足以区分“有意设计”与“偶然实现细节”的上下文时，生成的 DESIGN.md 质量会明显更高。如果你的目标不止是单个屏幕，就让技能综合一组有代表性的样本，而不是逼它从一个弱样本里硬推断整个系统。

design-md 技能常见问题

design-md 只适用于 Stitch 项目吗？

是的，design-md 技能是专门为 Stitch 项目和 Stitch MCP 访问而构建的。如果你不使用 Stitch，通常更适合用通用设计提示词，或者选择其他文档化工作流。

运行前我需要提供什么？

至少要提供一个目标项目，或者一种能识别它的方法，再加上你想分析的屏幕或屏幕集合。目标越具体，design-md 在构建设计语义系统时需要猜测的内容就越少。

design-md 技能适合新手吗？

适合。只要你能说出项目名和屏幕名，就可以开始使用。新手最常见的错误，是在没有给技能一个真实的事实来源时，就要求它直接产出设计文档。只有在它能检查实际的 Stitch 资产，而不是从模糊提示里猜风格时，这项技能才会表现最好。

什么时候不该用它？

如果你只需要快速的视觉印象、偏营销文案风格的描述，或者一段话式的 UI 点评，就不该用 design-md。如果你无法访问 Stitch MCP 工具，或者项目里没有足够有意义的设计数据，它也不是合适选择。

如何改进 design-md 技能

把目标收窄到更高信号的范围

design-md skill 最强的输出，来自聚焦明确的提示。请指定要文档化的具体屏幕、流程或项目片段，并说明你想要的是基础级系统、组件导向系统，还是可直接用于生成的提示指南。这样技能才能优先抓住最有复用价值的内容。

传达真正重要的设计决策

如果你已经知道哪些约束应该影响 DESIGN.md，一开始就说清楚：品牌语气、可访问性预期、布局密度、响应式行为，或者输出应更偏编辑化语言还是实现细节。这一点对 design-md for Design Systems 尤其重要，因为真正的目标是保留可重复的设计选择，而不是逐个描述所有可见元素。

警惕最常见的失败模式

最大的风险，是过度拟合某一个屏幕，或者把一次性的 UI 内容误当成系统规则。你可以要求区分核心 token、可复用模式和仅限单屏的例外，来提升结果质量。如果第一版太泛，就再补一轮提示，要求在颜色角色、字体层级、间距逻辑和组件行为上给出更强的指导。

从第一版 DESIGN.md 继续迭代

把第一版输出当作设计语言草稿，而不是最终成品。先检查它是否足够具体，能否支持 Stitch 生成；然后再针对薄弱部分提出修改，比如调色板角色、按钮状态或布局规则。最有用的 design-md install 结果，是一份未来提示词可以直接复用的 DESIGN.md，而不需要每次都重新解释整个系统。