SuperAPI AI 工具集

design-memory

设计与创作

查看项目

更新于 10-16 03:41

技能介绍

用途:design-memory 是 Sumi 命令体系中的 .sumi/ 设计记忆契约。它让 /style 一次性确定视觉方向,/screen、/component、/page、/fix 等命令直接消费该结果,而不必每次重新发明配色。在 v4.1.0 之前没有书面定义,四个命令以四种不同结构写 .sumi/style.json,本技能提供唯一定义。

主要能力:规定规范化的 .sumi/style.json 信封结构,包含 $sumi、meta、project、tokens、tone、references;其中 tokens 下使用 W3C DTCG 格式,涵盖 color、typography、space、radius、shadow、duration、easing、z 与 $themes。同时定义文件集合:style.json、brief.json、map.json、vision.json、wireframe-<screen>.json、generated-<asset>.json、refs/ 与 decisions.log(追加式 NDJSON)。

使用方式:明确归属,写入者只改自己的子树,例如 /palette 管 tokens.color、/type 管 tokens.typography、/dark 管 tokens.$themes.dark、/inspo 只管 .sumi/refs/,其余只读。读取顺序由宽到具体:brief.json、map.json、refs/board.json、style.json、vision.json、wireframe-<screen>.json、decisions.log,后者覆盖前者。合并采用读-改-写与深合并,绝不整文件替换,并更新 meta.updatedBy 与 meta.generated。优先级为显式用户指令 > 设计记忆 > 默认值。

适用场景与限制:适用于多个 Sumi 命令共享同一设计上下文的项目。缺失文件表示尚未决定,可生成并询问是否持久化;部分文件表示已有部分已决定,只补空缺。存在 style.json 时不得另造 token。若写入会改变其他命令此前设置的值,需一次性提示两个值并询问,不可静默覆盖。完整 JSON Schema、合并示例与 v4.1.0 前文件迁移说明见 references/sumi-file-schemas.md。