ss-setup

在此工作流之前，请先执行一次本会话的 更新预检。

StyleSeed 设置

StyleSeed 设置选择的是结果的设计方法，而不是要模仿的偏爱品牌。 使用 /ss-resolve --list（Claude Code）或 $ss-resolve --list（Codex）查看受支持的 语法、适配器、领域、页面、配方、调色板和配置文件 ID，无需加载完整手册。

何时不使用

• 项目已有有效的 STYLESEED.md → 使用 /ss-update。
• 用户提供的参考未由内置语法表示 → 设置前运行 /ss-reference，然后选择编译后的语法。
• 已有设计系统中的单个组件 → /ss-component。

方法、审查和参考编译器与框架无关。目前随附的组件脚手架面向 React 和 Tailwind v4；在其他 技术栈上，请配置锁定项并应用此方法，不要假装脚手架可以跨技术栈通用。

向导 — 一次只做一个决定

1. 产品用途和界面

询问正在构建什么、由谁使用，以及它是移动端/桌面端产品、网站、 社交轮播、幻灯片、文档/报告，还是单帧图形。从 ADAPTERS.md 中选择一个界面适配器，然后推断领域和页面/作品类型。

2. 输出语法

从 RULESETS.md 中恰好推荐一种语法，并用一句话说明它与产品用途的匹配之处：

• consumer-service
• operations-console
• technical-instrument
• editorial-reading
• commerce-conversion
• institutional-service
• expressive-marketing
• sequential-story
• /ss-reference 已编译某项语法时使用 reference:<slug>

不要将 Toss 推荐为通用默认选项。它只是 consumer-service 的一个参考系列。如果都不适合且用户有参考资料，请转至 /ss-reference。

3. 页面类型和领域倾向

确认具体页面类型（仪表盘、表单、落地页、详情、列表、设置、引导），并阅读其领域 × 页面交叉项。它决定构图；美学配置文件不决定构图。

4. 品牌配方

从 BRAND-RECIPES.md 中推荐一种形态。维护的语法映射适用时使用 auto。如果产品需要不同的几何结构、容器方式、 导航、控件或集合表达方式，请使用明确配方。配方不是对某家公司的克隆，也不负责选择颜色。

5. 调色板配方

从 PALETTE-RECIPES.md 中推荐一种语义调色板。维护的配方映射适用时使用 auto。明确指定的调色板仍须保留语义角色、表面/界面装饰的区分、 状态提示和经验证的对比度。配方代表产品的设计取向，而不是有限的色板列表。 用户提供关键颜色时，请选择感知特征、明暗环境、表面冷暖和强调色关系；随后由 $ss-resolve 推导实际的 OKLCH 色阶和角色。 选择调色板并不意味着可以随意更改所有表面的颜色。

6. 可选美学配置文件

仅当能强化产品时，才从 PRESETS.md 中推荐一个配置文件。none 是不错的默认选项。配置文件可以调整相互协调的视觉维度，但不能替代输出语法。

7. 品牌和有界维度

若用户提供了真实品牌色，则锁定该颜色；否则从所选调色板的主角色开始。若用户提供了关键颜色，请根据产品取向推荐 calm|balanced|vivid|deep，不要询问无边界的情绪词。然后确认浅色/深色模式、neutral|warm|cool 表面，以及 auto|tonal|adjacent|contrast 强调色关系。确认字体/语言、密度、圆角、立体效果、图像/数据角色和动效均处于语法允许的范围内。不要使用通用靛蓝色，也不要把过时的紫色误标为 Toss。

7a. 空间关系

在选定数值前，先说明预期的分组方式和间距取舍。保留现有间距令牌。对于注册表产品 UI，请使用解析器的空间角色指南，分别推荐并持久化页面内边距、区块／组／堆叠／行内间距，以及组件内边距。 排版和点击目标应独立处理。旧版设置保留原生令牌；不要臆造未解析的锁定字段。建议只是初步方案，并非已批准或经过质量测量的结果。

8. 编写设计锁定文件

创建 STYLESEED.md：

# StyleSeed — Design Lock

- 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. 搭建框架并验证

先编译所选方法，再编写代码：

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 完成验证。如果无法进行视觉渲染，请说明已跳过。

完成报告

报告所选语法及原因、页面／领域交集、品牌方案、调色板方案、可选配置、锁定文件路径、 已编译规则包和清单路径、变更文件、评分，以及视觉验证状态。说明未来需要使用自身语法的参考资料应通过 /ss-reference 处理。

规则

• 一次只问一个问题，并推荐一个具体的默认选项。
• 输出语法为必需项；美学配置为可选项。
• 品牌方案为必需项；auto 会解析为一个具体的受维护方案。
• 调色板方案为必需项；auto 会解析为经过对比度验证的语义调色板。
• 皮肤是令牌，而非设计判断。
• 切勿获取品牌的 DESIGN.md，并将其调色板视为完整规则集。
• 切勿搭建未经评分的首个页面，也不要在没有截图的情况下声称已完成视觉验证。