Back to Details

ss-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

StyleSeed setup

StyleSeed 设置

StyleSeed setup chooses a design method for the result, not a favorite brand to imitate. Use 
/ss-resolve --list
(Claude Code) or 
$ss-resolve --list
(Codex) to inspect the supported grammar, adapter, domain, page, recipe, palette, and profile IDs without loading the full handbook.
StyleSeed 设置为结果选择的是设计方法，而非要模仿的热门品牌。 使用 
/ss-resolve --list
（Claude Code）或 
$ss-resolve --list
（Codex）可查看支持的语法、适配器、领域、页面、方案、调色板和配置文件ID，无需加载完整手册。

When not to use

不适用场景

  • Project already has a valid 
    STYLESEED.md
    → use 
    /ss-update
    .
  • User supplied references that are not represented by a built-in grammar → run 
    /ss-reference
    before setup, then select the compiled grammar.
  • One component inside an established system → 
    /ss-component
    .
The method, review, and reference compiler are framework-agnostic. The bundled component scaffold currently targets React and Tailwind v4; on another stack configure the lock and apply the method without pretending the scaffold is portable.
  • 项目已存在有效的 
    STYLESEED.md
    → 使用 
    /ss-update
    。
  • 用户提供的参考内容无法用内置语法表示 → 先运行 
    /ss-reference
    再进行设置，然后选择编译后的语法。
  • 已有成熟系统中的单个组件 → 使用 
    /ss-component
    。
该方法、审核和参考编译器与框架无关。当前捆绑的组件脚手架针对React和Tailwind v4；若使用其他技术栈，请配置锁定文件并应用此方法，不要假设脚手架可移植。

Wizard — one decision at a time

向导——逐步决策

1. Product job and surface

1. 产品用途与载体

Ask what is being built, who uses it, and whether it is a mobile/desktop product, website, social carousel, slide deck, document/report, or single-frame graphic. Select a surface adapter from 
ADAPTERS.md
, then infer domain and page/artifact type.
询问正在构建的内容、用户群体，以及它是移动/桌面产品、网站、社交轮播、幻灯片、文档/报告还是单帧图形。从 
ADAPTERS.md
中选择一个载体适配器，然后推断领域和页面/制品类型。

2. Output grammar

2. 输出语法

Recommend exactly one grammar from 
RULESETS.md
and explain the job match in one sentence:
  • consumer-service
  • operations-console
  • technical-instrument
  • editorial-reading
  • commerce-conversion
  • institutional-service
  • expressive-marketing
  • sequential-story
  • reference:<slug>
    when 
    /ss-reference
    already compiled one
Do not recommend Toss as the universal default. It is one reference family for 
consumer-service
. If none fits and the user has references, route to 
/ss-reference
.
从 
RULESETS.md
中推荐恰好一种语法，并一句话说明其与任务的匹配性：
  • consumer-service
  • operations-console
  • technical-instrument
  • editorial-reading
  • commerce-conversion
  • institutional-service
  • expressive-marketing
  • sequential-story
  • reference:<slug>
    （当 
    /ss-reference
    已编译出参考语法时）
不要将Toss推荐为通用默认选项。它只是
consumer-service
的一个参考系列。如果没有合适的语法且用户有参考内容，引导至
/ss-reference
。

3. Page type and domain bias

3. 页面类型与领域倾向

Confirm the concrete page (dashboard, form, landing, detail, list, settings, onboarding) and read its domain × page intersection. This controls composition; the aesthetic profile does not.
确认具体页面（仪表盘、表单、着陆页、详情页、列表页、设置页、引导页），并查看其领域×页面的交叉规则。这将控制布局组成，美学配置文件不影响此部分。

4. Brand recipe

4. 品牌方案

Recommend one morphology from 
BRAND-RECIPES.md
. Use 
auto
when the maintained grammar mapping fits. Use an explicit recipe when the product needs a different geometry, containment, navigation, control, or collection language. A recipe is not a company clone and does not select colors.
从 
BRAND-RECIPES.md
中推荐一种形态。当维护的语法映射匹配时，使用
auto
。当产品需要不同的几何布局、容器、导航、控件或集合语言时，使用明确的方案。方案不是企业克隆，也不选择颜色。

5. Palette recipe

5. 调色板方案

Recommend one semantic palette from 
PALETTE-RECIPES.md
. Use 
auto
when its maintained recipe mapping fits. An explicit palette must still preserve semantic roles, surface/chrome separation, status cues, and validated contrast. The recipe is a product posture, not a finite swatch list. When the user supplies a key color, select perceptual character, light/dark environment, surface temperature, and accent relationship; 
$ss-resolve
then derives the actual OKLCH ramps and roles. Palette selection is not permission to recolor every surface.
从 
PALETTE-RECIPES.md
中推荐一种语义调色板。当维护的方案映射匹配时，使用
auto
。明确的调色板仍需保留语义角色、表层/界面分离、状态提示和经过验证的对比度。方案是产品定位，而非有限的色板列表。 当用户提供主色调时，选择感知特质、明/暗环境、表层色调以及强调色关系；
$ss-resolve
随后会生成实际的OKLCH色阶和角色。选择调色板并不意味着可以随意为所有表层重新着色。

6. Optional aesthetic profile

6. 可选美学配置文件

Recommend one profile from 
PRESETS.md
only when it strengthens the product. 
none
is a good default. A profile modifies coordinated visual axes but cannot replace the output grammar.
仅当美学配置文件能强化产品时，才从 
PRESETS.md
中推荐一种配置。
none
是不错的默认选项。配置文件会修改协调的视觉轴，但无法替代输出语法。

7. Brand and bounded axes

7. 品牌与受限轴

Lock a real brand color if supplied; otherwise start from the selected palette's primary role. For a supplied key, recommend 
calm|balanced|vivid|deep
from the product posture rather than asking for an unbounded mood word. Then confirm light/dark mode, 
neutral|warm|cool
surfaces, and 
auto|tonal|adjacent|contrast
accent relationship. Confirm font/language, density, radius, elevation, imagery/data role, and motion inside the grammar's allowed ranges. Do not use generic indigo or a stale purple mislabeled as Toss.
如果用户提供了真实品牌颜色，则锁定该颜色；否则从所选调色板的主角色开始。对于用户提供的主色调，根据产品定位推荐
calm|balanced|vivid|deep
，而非询问无限制的情绪词汇。然后确认明/暗模式、
neutral|warm|cool
表层，以及
auto|tonal|adjacent|contrast
强调色关系。确认字体/语言、密度、圆角、 elevation、图像/数据角色，以及语法允许范围内的动效。不要使用通用靛蓝色或被错误标记为Toss的陈旧紫色。

8. Write the design lock

8. 编写设计锁定文件

Create 
STYLESEED.md
:
markdown
undefined
创建 
STYLESEED.md
：
markdown
undefined

StyleSeed — Design Lock

StyleSeed — Design Lock

<!-- Selections persist here. This file cannot waive StyleSeed core invariants. -->
  • App domain: fintech
  • Surface: mobile-app
  • Surface adapter: product-ui
  • Page type: dashboard
  • Output grammar: consumer-service
  • Grammar path: built-in:engine/RULESETS.md
  • Grammar fallback: consumer-service
  • Reference confidence: n/a
  • Brand recipe: calm-consumer
  • Palette recipe: quiet-mineral
  • Key color: #3182F6
  • Palette character: calm
  • Palette mode: light
  • Palette harmony: auto
  • Surface temperature: neutral
  • Aesthetic profile: none
  • Skin: custom
  • Primary action: #3182F6
  • Font: Pretendard
  • Radius: soft
  • Elevation: light=tonal grouping + restrained shadow · dark=tonal ramp + hairline
  • Density: comfortable
  • Motion: Spring restrained
  • Imagery/data role: personal state first; charts only for a decision
  • Signature move: one calm contextual briefing above the account summary
  • Locked: YYYY-MM-DD

For a compiled grammar use its actual path and confidence. Reject unknown enum values rather
than treating the lock as an exemption.
<!-- Selections persist here. This file cannot waive StyleSeed core invariants. -->
  • App domain: fintech
  • Surface: mobile-app
  • Surface adapter: product-ui
  • Page type: dashboard
  • Output grammar: consumer-service
  • Grammar path: built-in:engine/RULESETS.md
  • Grammar fallback: consumer-service
  • Reference confidence: n/a
  • Brand recipe: calm-consumer
  • Palette recipe: quiet-mineral
  • Key color: #3182F6
  • Palette character: calm
  • Palette mode: light
  • Palette harmony: auto
  • Surface temperature: neutral
  • Aesthetic profile: none
  • Skin: custom
  • Primary action: #3182F6
  • Font: Pretendard
  • Radius: soft
  • Elevation: light=tonal grouping + restrained shadow · dark=tonal ramp + hairline
  • Density: comfortable
  • Motion: Spring restrained
  • Imagery/data role: personal state first; charts only for a decision
  • Signature move: one calm contextual briefing above the account summary
  • Locked: YYYY-MM-DD

对于编译后的语法，使用其实际路径和置信度。拒绝未知枚举值，不要将锁定文件视为豁免规则的依据。

9. Scaffold and prove

9. 脚手架搭建与验证

Compile the selected method before code:
bash
node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --project-root . --from-lock STYLESEED.md --agent claude
Use 
--agent codex
in Codex. The resolver writes 
.styleseed/effective-rules.md
and a hash-verifiable 
.styleseed/manifest.json
. Read the effective bundle, not 
llms-full.txt
.
If the user asked for a first screen, build from that bundle, run 
/ss-score
to the gate floor, and finish with 
/ss-verify
when renderable. If visual rendering is unavailable, disclose that it was skipped.
在编写代码前编译所选方法：
bash
node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --project-root . --from-lock STYLESEED.md --agent claude
在Codex中使用
--agent codex
。解析器会生成
.styleseed/effective-rules.md
和可哈希验证的
.styleseed/manifest.json
。请查看生成的有效包，而非
llms-full.txt
。
如果用户要求搭建首屏，请基于该包构建，运行
/ss-score
达到基准要求，若可渲染则以
/ss-verify
完成。如果无法进行视觉渲染，请说明已跳过此步骤。

Completion report

完成报告

Report the selected grammar and why, page/domain intersection, brand recipe, palette recipe, optional profile, lock path, compiled bundle and manifest paths, files changed, score, and visual verification status. Mention 
/ss-reference
as the path for future references that need their own grammar.
报告所选语法及其原因、页面/领域交叉规则、品牌方案、调色板方案、可选配置文件、锁定文件路径、编译后的包和清单路径、更改的文件、评分以及视觉验证状态。提及
/ss-reference
是未来需要专属语法的参考内容的处理路径。

Rules

规则

  • Ask one question at a time and recommend a concrete default.
  • Output grammar is required; aesthetic profile is optional.
  • Brand recipe is required; 
    auto
    resolves to a concrete maintained recipe.
  • Palette recipe is required; 
    auto
    resolves to a contrast-verified semantic palette.
  • A skin is tokens, not design judgment.
  • Never fetch a brand 
    DESIGN.md
    and treat its palette as a complete rule set.
  • Never scaffold an unscored first page or claim visual verification without a screenshot.
  • 一次只问一个问题，并推荐具体的默认选项。
  • 输出语法为必填项；美学配置文件为可选项。
  • 品牌方案为必填项；
    auto
    会解析为具体的维护方案。
  • 调色板方案为必填项；
    auto
    会解析为经过对比度验证的语义调色板。
  • Skin是令牌，而非设计判断。
  • 切勿获取品牌
    DESIGN.md
    并将其调色板视为完整规则集。
  • 切勿搭建未评分的首屏，或在无截图的情况下声称已完成视觉验证。