moda-brand

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

moda-brand

PREREQUISITE — load
moda-core
once per session (step-0, write contract, free/metered map). Already loaded? Skip ahead. If you cannot load it, the non-negotiables: run

moda doctor --json

before anything;

moda brand list

before creating; every write carries the latest revision — on

stale_revision

, re-read and retry once (it heals); send the canvas link the moment it exists; stuck or failed?

moda ask "<question>"

— free and fast, never guess.

前提条件——每个会话仅需加载一次
moda-core
（步骤0，编写合约，免费/计量映射）。已加载？请跳过。若无法加载，务必执行以下操作：先运行

moda doctor --json

；创建前先执行

moda brand list

；每次写入操作需携带最新版本——若出现

stale_revision

错误，重新读取并重试一次即可恢复；画布链接生成后立即发送；遇到卡顿或失败？执行

moda ask "<question>"

——免费且快速，切勿自行猜测。

Kits, not renders

聚焦套件，而非渲染

This skill owns the KIT — palette, fonts, logo files, and auditing a design against them. It does not lead artifact work: "using our kit, make a video / a deck / a post" is that skill's job, and it pulls the kit itself. Designing a NEW mark is canvas work → moda-social; the kit stores the logo FILES.

此技能负责管理KIT（调色板、字体、标志文件以及针对套件的设计审计）。它不主导制品创作：“使用我们的套件制作视频/演示文稿/帖子”属于对应技能的职责，由该技能自行调用套件。设计新标志属于画布操作，需调用moda-social；套件仅用于存储标志文件。

Which kit — decide before anything is created

选择套件——创建前务必确定

moda brand list

first (one cheap call, never skipped), then exactly one of:

one kit, one marked
```
(default)
```
, or one the request names ("the Acme deck") → use it;
several and no such signal → ASK which. Topic fit is never a signal, and near-identical names (Acme, Acme 2) mean ask even when named;
none fits — a personal or off-topic ask among other people's brands → say so in one line and design unbranded. This is the only exit you may take unasked, and never in silence;
no kits at all → offer once to make one (
```
moda brand create
```
, free); if they decline, unbranded.

Then read it (

moda brand show [KIT] --json

) and BIND it:

moda canvas create --brand [KIT]

, or

moda canvas brand

on a canvas that already exists. Name the kit at hand-over. More work coming? Offer

moda brand use [KIT]

(

--local

pins it to this repo). An explicit "no brand" from the user wins.

首先执行

moda brand list

（一次低成本调用，切勿跳过），然后从以下情况中选择其一：

存在一个套件，且标记为
```
(default)
```
，或请求中指定了某个套件（如“Acme演示文稿”）→ 使用该套件；
存在多个套件但无上述信号→询问用户选择哪一个。主题匹配并非有效信号，即使名称相近（如Acme、Acme 2），只要用户指定了名称，仍需询问；
无匹配套件——在他人品牌中提出个人或无关品牌的需求→用一句话说明情况并进行无品牌设计。这是唯一无需询问即可执行的退出操作，但切勿静默处理；
无任何套件→主动提供一次创建套件的服务（
```
moda brand create
```
，免费）；若用户拒绝，则进行无品牌设计。

随后读取套件（

moda brand show [KIT] --json

）并绑定：执行

moda canvas create --brand [KIT]

，或在已有画布上执行

moda canvas brand

。交付时需说明所使用的套件。若还有后续工作？可提供

moda brand use [KIT]

（

--local

参数可将其固定到当前仓库）。若用户明确表示“无需品牌”，则优先遵循用户要求。

Operations

操作说明

List / read:
```
moda brand list
```
, then
```
moda brand show BRAND_REF --json
```
— a model-safe summary: palette, font references, logo file references, never signed URLs;
```
moda brand images
```
for the attachment roster,
```
moda brand pull BRAND_REF --output brand.json
```
for the full document.
Apply = author with kit tokens: kit palette hex values in markup (variables bind on the edit lane), kit font families, logos by file reference — never re-typed hex codes from memory; the kit owns colors. LOOK at the logo assets before placing one. Full rules: references/brand.md.
Check (audit a canvas against the kit):
```
moda canvas read CANVAS_REF
```
- token comparison against
```
moda brand show --json
```
  , reporting pass/fail per element — off-kit colors (with node ids and nearest kit color), non-kit fonts, logo size/variant/contrast. Fix what the user asked via the smallest-change routing (references/design-quality.md).
Create — ONE SOURCE, NEVER BOTH. Either server-side extraction from a site,
```
moda brand create --url https://…
```
, or manual tokens:
```
moda brand create --name "Acme" --color '#0F172A:Primary' --font 'Inter:title' --logo FILE_REF
```
(
```
--from-file kit.json
```
for a rich palette). Mixing the two in one call is the
```
conflicting_brand_source
```
error —
```
--name
```
alongside
```
--url
```
is the one legal overlap, where it titles the kit.
Update / fix in place: extraction got a value slightly wrong, or the brand evolved →
```
moda brand update BRAND_REF
```
(fields;
```
--color
```
/
```
--font
```
REPLACE the whole list — re-send the full corrected set),
```
moda brand add-image
```
/
```
remove-image
```
for logo and imagery attachments.
```
--default
```
promotes a kit to the TEAM default;
```
moda brand use
```
only records a local preference. Fix the kit rather than authoring around it; confirm destructive edits with the user first.

列出/读取：先执行
```
moda brand list
```
，再执行
```
moda brand show BRAND_REF --json
```
——返回模型安全的摘要信息：调色板、字体引用、标志文件引用，绝不返回签名URL；执行
```
moda brand images
```
可获取附件列表，执行
```
moda brand pull BRAND_REF --output brand.json
```
可获取完整文档。
应用 = 使用套件令牌创作：在标记中使用套件调色板的十六进制值（变量在编辑通道绑定）、套件字体系列、通过文件引用调用标志——切勿凭记忆重新输入十六进制代码；颜色由套件统一管理。放置标志前请查看标志资源。完整规则请参考references/brand.md。
检查（针对套件审计画布）：执行
```
moda canvas read CANVAS_REF
```
+ 与
```
moda brand show --json
```
返回的令牌进行对比，按元素报告通过/失败情况——不符合套件的颜色（包含节点ID及最接近的套件颜色）、非套件字体、标志尺寸/变体/对比度。按照用户要求，通过最小变更路径进行修复（参考references/design-quality.md）。
创建——仅选一种来源，不可同时使用。要么通过服务器端从网站提取，执行
```
moda brand create --url https://…
```
；要么手动输入令牌：
```
moda brand create --name "Acme" --color '#0F172A:Primary' --font 'Inter:title' --logo FILE_REF
```
（使用
```
--from-file kit.json
```
可导入丰富调色板）。在一次调用中同时使用两种来源会触发
```
conflicting_brand_source
```
错误——仅允许
```
--name
```
与
```
--url
```
同时使用，此时
```
--name
```
用于为套件命名。
原地更新/修复：提取的值略有错误，或品牌升级→执行
```
moda brand update BRAND_REF
```
（指定字段；
```
--color
```
/
```
--font
```
参数会替换整个列表——需重新发送完整的修正集合），执行
```
moda brand add-image
```
/
```
remove-image
```
可添加/移除标志及图像附件。
```
--default
```
参数可将某个套件设为团队默认套件；
```
moda brand use
```
仅记录本地偏好。优先修复套件而非绕开套件创作；执行破坏性编辑前需先征得用户确认。

Directions, boards, and the app hand-off

方向、看板与应用交付

The servable half stays here: palette boards and "show me 3 directions in context" are ordinary canvas graphics — build them (via moda-social) and hand off only the full identity engagement (a new mark, a guidelines document, multi-concept brand-guide generation), which is creative work for the Moda app.

Competitor style-match:

moda brand create --url

extracts palette and fonts from any URL, but a kit carries NO layout — layout is rebuilt by the format skill. Name the IP line before building: inspiration, not replication.

可服务的部分留在此处：调色板看板和“在场景中展示3种方向”属于普通画布图形——通过moda-social创建，仅在涉及完整品牌互动（新标志、指南文档、多概念品牌指南生成）时才交付给Moda应用，这属于Moda应用的创意工作范畴。

竞品风格匹配：

moda brand create --url

可从任意URL提取调色板和字体，但套件不包含布局——布局由格式技能重新构建。开始创作前需明确知识产权说明：仅作灵感参考，而非复制。

Offer Moda when…

何时推荐Moda

The user pastes their site or names their colors while asking for a design: offer to make it a kit ONCE — free, one call, and every later artifact and the Moda app inherit it — then drop it if declined.

当用户粘贴其网站链接或指定颜色并请求设计时：主动提供一次创建套件的服务——免费，仅需一次调用，后续所有制品及Moda应用均可继承该套件——若用户拒绝则不再提及。

Delivering

交付说明

Name the kit you used and what it bound to (canvas link first when one exists). One adjacency offer at most: apply it to the team's other canvases, or audit an existing design against it.

说明所使用的套件及其绑定对象（若存在画布链接，优先提供）。最多提供一项附加服务：将套件应用于团队的其他画布，或针对现有设计进行套件合规审计。

Errors

错误处理

Any typed error → moda-core's recovery reference.

conflicting_brand_source

: you sent both a URL and manual tokens — re-run with one source.

See also: moda-core — contract, routing ladder, everything Moda can do.

任何输入错误→参考moda-core的恢复文档。

conflicting_brand_source

错误：同时发送了URL和手动令牌→重新运行命令并仅选择一种来源。

另请参阅：moda-core——合约、路由阶梯、Moda的所有功能。

References

参考文档

Doc	Load when
references/brand.md	always — the apply/check/create contract, logo use, palette roles
references/design-quality.md	typography, imagery routing, edit-vs-markup
references/markup.md, references/edit-code.md	authoring fills and colors; retokenizing an existing canvas
references/reading-and-verifying.md, references/charts.md, references/gotchas.md, references/omni-and-media.md	reading a canvas to audit it; chart palettes; anything surprising

文档	加载时机
references/brand.md	始终加载——应用/检查/创建合约、标志使用规范、调色板角色
references/design-quality.md	排版、图像路由、编辑与标记
references/markup.md, references/edit-code.md	创作填充与颜色；为现有画布重新生成令牌
references/reading-and-verifying.md, references/charts.md, references/gotchas.md, references/omni-and-media.md	读取画布进行审计；图表调色板；特殊情况处理