mcpField
R
reference-design-contract

reference-design-contract

github.com/nexu-io设计与 UI104.6k1.8k 次安装今天更新
代码仓库

关于 reference-design-contract

reference-design-contract 是将设计参考和风格线索整理成明确、可复用设计约定的技能,适用于准备原型、演示稿、改版或图像再创作的团队。它还会生成决策记录和实现交接说明。

主要功能

  1. 01创建包含九个部分的 `DESIGN.md`
  2. 02记录依据、决策、边界和风险
  3. 03生成实现交接说明
  4. 04可创建简要的 `example.html` 预览
  5. 05依据检查清单验证输出

适用场景

  1. 01将视觉参考整理为可复用设计方向
  2. 02为编码 Agent 准备实现说明
  3. 03记录改版中需要保留或调整的内容

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nexu-io/open-design --skill reference-design-contract

安装后在 Claude Code 中输入/reference-design-contract确认已加载。

附带文件example.htmlreferences/checklist.md

详细介绍

参考设计契约

当用户提供了审美倾向、参考资料,或提出粗略的“像这样”的需求,并且需要在生成前建立可复用的设计契约时,请使用此技能。目标不是写一段更长的提示词,而是明确设计决策,让后续原型、演示文稿、重设计或图像混编无需猜测即可执行。

此技能的产出

创建三个文件:

  1. DESIGN.md — 可复用的视觉方向,遵循 OpenDesign 的标准九部分设计系统结构。
  2. design-contract.md — 决策记录:使用的证据、保留/更改边界、理由、风险和质量门槛。
  3. implementation-handoff.md — 为下一个产出成品的技能或编码 Agent 编写的简明构建说明。

如果预览有帮助,也请创建 example.html,作为手工制作的小型契约预览。不要把它作为主要交付物。

工作流程

  1. 明确任务。 确定目标成品类型、受众、品牌/产品背景、参考资料和限制条件。只有在缺失的信息会改变方向时,才最多提两个问题。否则,选择合理的默认方案,并标注为推断。
  2. 审阅证据。 使用用户提供的截图、URL、现有的 DESIGN.md、品牌文档、图像素材或备注。如果缺少证据,请说明,并仅依据需求说明制定契约;不要捏造品牌信息。
  3. 区分参考资料的语义。 对每项参考资料,分别说明:
    • Keep:要保留的特征,例如密度、构图、材质、字体节奏、色温或动效风格。
    • Change:主题内容、文案、品牌标识、具体布局、受保护素材,以及用户希望调整的任何内容。
    • Do not copy:示例中的实际截图、标志、声明、价格、专有 UI 或确切提示词。
  4. 确定设计方向。 选择一个连贯的视觉立场。不要提供五个互不相关的情绪板。如果确实存在相互竞争的方向,请简要列出,选出建议方向后继续。
  5. 编写 DESIGN.md。 使用以下九个标题,保持完全一致:
    • ## 1. Visual Theme & Atmosphere
    • ## 2. Color
    • ## 3. Typography
    • ## 4. Spacing & Grid
    • ## 5. Layout & Composition
    • ## 6. Components
    • ## 7. Motion & Interaction
    • ## 8. Voice & Brand
    • ## 9. Anti-patterns
  6. 编写 design-contract.md。 包含:
    • 目标和目标成品
    • 带置信度(observed、provided、inferred)的证据表
    • 保留/更改/不复制表
    • 用一段话说明最终设计立场
    • 风险和明确的未知事项
    • 质量门槛检查清单
  7. 编写 implementation-handoff.md。 简短且便于执行:
    • 要阅读的文件
    • 设计令牌/配色/字体/布局限制
    • 素材规则
    • 响应式要求
    • “首个成品应证明……”验收说明
  8. 验证。 阅读 references/checklist.md,并在最终交接前满足所有 P0 门槛。

输出规则

  • 每项陈述都必须能追溯到用户输入、观察到的参考证据,或明确标注的推断。
  • 优先使用具体限制,而非形容词:“只用一种暖色强调色,不要紫色或蓝色辉光”胜过“高端”。
  • 将“采用相同风格”理解为“借鉴可控特征”,而不是“克隆原始主题或提示词”。
  • 如果用户还要求立即生成 UI,请先完成这些契约文件,再于下一步交接给相应的成品制作技能。

评论

支持 Markdown