ss-studio

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Build a directed interactive concept

构建定向交互概念

Run the full Studio pipeline. Do not reduce it to a moodboard, a static image, or a set of arbitrary motion effects.

运行完整的Studio流程。请勿将其简化为情绪板、静态图像或任意一组动效。

Start the run

启动运行

Read

STUDIO-PIPELINE.md

PRODUCT-PRINCIPLES.md

, and the resolved project rules first. If the project has no valid

STYLESEED.md

, run setup and resolve before Studio.

Initialize a durable run:

bash

node <skill-dir>/scripts/studio-run.mjs init \
  --project-root . \
  --name "<project or concept>" \
  --brief "<product job and desired interaction>" \
  --surface mobile-app \
  --platform web

The command prints the run directory under

.styleseed/studio/

. Use the artifact schemas in

references/artifact-contract.md

. Use

references/provider-adapters.md

only when media generation or recording is required.

首先阅读

STUDIO-PIPELINE.md

、

PRODUCT-PRINCIPLES.md

以及已确定的项目规则。如果项目没有有效的

STYLESEED.md

，请先运行设置并完成解析，再启动Studio。

初始化一个持久化运行任务：

bash

node <skill-dir>/scripts/studio-run.mjs init \
  --project-root . \
  --name "<project or concept>" \
  --brief "<product job and desired interaction>" \
  --surface mobile-app \
  --platform web

该命令会在

.styleseed/studio/

下输出运行目录。使用

references/artifact-contract.md

中的工件架构。仅在需要媒体生成或录制时使用

references/provider-adapters.md

。

1. Scout by role

1. 按角色调研

Classify supplied and discovered references as

structure

navigation

signature

motion

, or

asset-language

. Capture source URL/path, date, visible observation, transferable principle, confidence, and rights note. Never claim visual evidence for a reference that was not actually seen.

Do not ask the user to collect a generic moodboard. Find only the missing roles. Keep product UI, marketing presentation, and generated media separate unless the brief explicitly connects them.

将提供的及发掘的参考资料分类为

structure

（结构）、

navigation

（导航）、

signature

（标志性元素）、

motion

（动效）或

asset-language

（资产语言）。记录来源URL/路径、日期、可见观察结果、可迁移原则、置信度及版权说明。切勿为未实际查看过的参考资料声称有视觉证据。

请勿要求用户收集通用情绪板。仅查找缺失的角色类别。除非简报明确说明，否则请将产品UI、营销展示及生成的媒体分开处理。

2. Produce three directions

2. 产出三个方向

Write exactly three entries in

directions.json

native

signature

, and

experimental

. Keep the product job and content fixed; vary at least two structural axes. Every direction must include:

composition and focal logic;
navigation chrome versus content canvas;
one semantic palette recipe, type, and material roles;
generated asset strategy;
motion and continuity logic;
one product-specific signature move;
output grammar, brand recipe, trade-offs, implementation cost, and risk.

Advance only after the directions validate:

bash

node <skill-dir>/scripts/studio-run.mjs advance --project-root . --run <id> --stage directed

在

directions.json

中撰写恰好三个条目：

native

（原生风格）、

signature

（标志性风格）和

experimental

（实验性风格）。保持产品任务和内容固定；至少在两个结构维度上做出差异化。每个方向必须包含：

布局与焦点逻辑；
导航控件与内容画布的区分；
一套语义化配色方案、字体及材质角色定义；
生成资产策略；
动效与连贯性逻辑；
一个产品专属的标志性交互动作；
输出规范、品牌方案、权衡点、实施成本及风险。

在方向验证通过后再推进流程：

bash

node <skill-dir>/scripts/studio-run.mjs advance --project-root . --run <id> --stage directed

3. Require a selection

3. 确认选定方向

Show the three directions together. Record the user's selection and rationale. Do not average them or quietly choose the easiest one.

bash

node <skill-dir>/scripts/studio-run.mjs select \
  --project-root . --run <id> --direction <direction-id> \
  --by "<reviewer>" --rationale "<decision>"

将三个方向一同展示。记录用户的选择及理由。请勿对方向进行折中处理，也不要私下选择最容易实现的那个。

bash

node <skill-dir>/scripts/studio-run.mjs select \
  --project-root . --run <id> --direction <direction-id> \
  --by "<reviewer>" --rationale "<decision>"

4. Compile scenes and media jobs

4. 编译场景与媒体任务

Write

scenes.json

assets.json

, and

video.json

from the selected direction.

An interaction scene defines trigger, states, continuity, enter/exit, feedback, interruption, reduced-motion behavior, and renderer targets.
An asset job defines capability, prompt, inputs, output, provenance, rights note, fallback, and consuming scene.
A video plan starts with real prototype recordings. Mark generative shots explicitly; never use them to fake an interaction that does not work.

Map capability to an available provider only at execution time. If the needed provider is absent, leave the job

blocked

and report the exact missing capability.

Record provider execution without hand-editing the run:

bash

node <skill-dir>/scripts/studio-run.mjs media \
  --project-root . --run <id> --job <job-id> --status complete \
  --provider <tool/model> --output <project-relative-path> \
  --provenance "<model · date · source inputs>"

根据选定的方向撰写

scenes.json

、

assets.json

和

video.json

。

交互场景需定义触发条件、状态、连贯性、进入/退出效果、反馈、中断处理、简化动效行为及渲染目标。
资产任务需定义能力要求、提示词、输入、输出、来源、版权说明、备选方案及使用该资产的场景。
视频计划需从真实原型录制开始。明确标记生成式镜头；切勿用它们伪造无法实现的交互效果。

仅在执行阶段将能力映射到可用的提供商。若所需提供商不存在，请将任务标记为

blocked

（受阻）并报告具体缺失的能力。

无需手动编辑运行记录即可记录提供商的执行情况：

bash

node <skill-dir>/scripts/studio-run.mjs media \
  --project-root . --run <id> --job <job-id> --status complete \
  --provider <tool/model> --output <project-relative-path> \
  --provenance "<model · date · source inputs>"

5. Generate, build, and record

5. 生成、构建与录制

Generate raster assets only for imagery, texture, illustration, footage, or product material. Keep UI geometry, icons, and final copy code-native and accessible. Copy final generated files into the run directory and preserve prompts and provenance.

Build the selected direction as a working prototype. Implement its primary navigation, signature scene, cancel/back behavior, and reduced-motion fallback. Record the actual prototype after it passes the code and pixel gates. Optional generated footage may be composited as labeled media.

Store prototype and recording paths through the CLI, then advance to

built

bash

node <skill-dir>/scripts/studio-run.mjs output \
  --project-root . --run <id> --prototype <route-or-path>
node <skill-dir>/scripts/studio-run.mjs advance \
  --project-root . --run <id> --stage built
node <skill-dir>/scripts/studio-run.mjs output \
  --project-root . --run <id> --recording <project-relative-path>

仅针对图像、纹理、插画、镜头素材或产品材质生成光栅资产。保持UI几何图形、图标及最终文案为代码原生且可访问。将最终生成的文件复制到运行目录，并保留提示词和来源信息。

将选定的方向构建为可运行的原型。实现其主要导航、标志性场景、取消/返回行为及简化动效备选方案。在原型通过代码和像素检查后，录制实际运行效果。可选的生成镜头素材可作为标记媒体进行合成。

通过CLI存储原型和录制路径，然后推进到

built

（已构建）阶段：

bash

node <skill-dir>/scripts/studio-run.mjs output \
  --project-root . --run <id> --prototype <route-or-path>
node <skill-dir>/scripts/studio-run.mjs advance \
  --project-root . --run <id> --stage built
node <skill-dir>/scripts/studio-run.mjs output \
  --project-root . --run <id> --recording <project-relative-path>

6. Verify and deliver

6. 验证与交付

Run StyleSeed score and visual verification, then inspect temporal evidence: start/mid/end frames, interrupt/cancel behavior, and reduced motion. Record

code

visual

temporal

, and

human

gate statuses plus evidence paths in

verification.json

Record each gate explicitly. A human pass requires a named reviewer:

bash

node <skill-dir>/scripts/studio-run.mjs gate \
  --project-root . --run <id> --gate temporal --status pass \
  --evidence <path> --note "start, mid, end, cancel, and reduced motion inspected"
node <skill-dir>/scripts/studio-run.mjs gate \
  --project-root . --run <id> --gate human --status pass \
  --reviewer "<name>" --evidence <path> --note "selected result accepted"

bash

node <skill-dir>/scripts/studio-run.mjs advance --project-root . --run <id> --stage verified
node <skill-dir>/scripts/studio-run.mjs status --project-root . --run <id>

Deliver the complete run folder, runnable prototype, actual recording, and unresolved risks. A polished reel by itself is not a completed Studio run.

运行StyleSeed评分和视觉验证，然后检查时序证据：开始/中间/结束帧、中断/取消行为及简化动效。在

verification.json

中记录

code

（代码）、

visual

（视觉）、

temporal

（时序）和

human

（人工）检查门的状态及证据路径。

明确记录每个检查门的情况。人工通过需指定评审人姓名：

bash

node <skill-dir>/scripts/studio-run.mjs gate \
  --project-root . --run <id> --gate temporal --status pass \
  --evidence <path> --note "start, mid, end, cancel, and reduced motion inspected"
node <skill-dir>/scripts/studio-run.mjs gate \
  --project-root . --run <id> --gate human --status pass \
  --reviewer "<name>" --evidence <path> --note "selected result accepted"

bash

node <skill-dir>/scripts/studio-run.mjs advance --project-root . --run <id> --stage verified
node <skill-dir>/scripts/studio-run.mjs status --project-root . --run <id>

交付完整的运行文件夹、可运行的原型、实际录制视频及未解决的风险。仅提供精美的展示视频并不代表Studio运行任务已完成。

Non-negotiables

不可协商规则

Keep exactly one selected design direction and one coherent product language.
Human selection precedes expensive generation and implementation.
Do not clone protected brand assets, copy, or trademarked arrangements.
Do not fabricate reference observations, provider outputs, file paths, or verification passes.
Do not let generated imagery carry essential UI text or interaction semantics.
Do not mark a run verified without seeing the pixels and the temporal result.

始终保留恰好一个选定的设计方向及一套连贯的产品语言。
人工选择优先于高成本的生成与实施工作。
请勿克隆受保护的品牌资产、文案或受商标保护的布局。
请勿伪造参考资料观察结果、提供商输出、文件路径或验证通过记录。
请勿让生成的图像承载关键UI文本或交互语义。
未查看像素效果及时序结果前，请勿标记运行任务为已验证。