ss-reference

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Compile references into a design grammar

将参考内容编译为设计语法

Do not merely imitate the supplied screen. Read
PRODUCT-PRINCIPLES.md
,
RULESETS.md
,
ADAPTERS.md
, and
REFERENCE-COMPILER.md
, then execute the compiler pipeline in full.
不要仅仅模仿提供的界面。请阅读
PRODUCT-PRINCIPLES.md
RULESETS.md
ADAPTERS.md
REFERENCE-COMPILER.md
,然后完整执行编译器流程。

Workflow

工作流程

  1. Ingest every supplied reference and assign evidence IDs (
    R1
    ,
    R2
    , ...). If a URL can be rendered, capture it. If an image cannot be seen, stop claiming visual analysis for it.
  2. Separate references by surface adapter and job. Do not merge a marketing homepage with an app dashboard unless the user explicitly wants both languages connected.
  3. Observe and measure the twelve axes. Every rule cites evidence IDs and a confidence level.
  4. Resolve contradictions instead of averaging them. Explain any material choice briefly.
  5. Choose the nearest built-in fallback grammar and adapter, then compile the project artifacts required by
    REFERENCE-COMPILER.md
    under
    .styleseed/rulesets/<slug>/
    .
  6. Update
    STYLESEED.md
    to select
    reference:<slug>
    while preserving bounded brand choices.
  7. Validate transfer: apply the grammar to one representative screen not present in the source set, run
    /ss-score
    , then
    /ss-verify
    if renderable. Fix and repeat to the gate floor.
  8. Report what was learned, what remains low-confidence, where the artifacts live, and the validation result.
  1. 接收所有提供的参考内容并分配证据ID(
    R1
    R2
    ……)。如果URL可渲染,请捕获它。如果无法查看图片,请停止对其进行视觉分析。
  2. 按界面适配器和任务对参考内容进行分类。除非用户明确希望关联两种设计语言,否则不要将营销首页与应用仪表板合并。
  3. 观察并衡量十二个维度。每条规则都需引用证据ID和置信度等级。
  4. 解决矛盾而非取平均值。简要说明任何重要的选择理由。
  5. 选择最接近的内置备用语法和适配器,然后按照
    REFERENCE-COMPILER.md
    的要求在
    .styleseed/rulesets/<slug>/
    下编译项目工件。
  6. 更新
    STYLESEED.md
    以选择
    reference:<slug>
    ,同时保留受限的品牌选择。
  7. 验证迁移效果:将语法应用于一个未在源集合中出现的代表性界面,运行
    /ss-score
    ,如果可渲染则运行
    /ss-verify
    。修复问题并重复此过程直至达到合格标准。
  8. 报告所学到的内容、仍存在低置信度的部分、工件的存储位置以及验证结果。

Rules

规则

  • Visible evidence before adjectives. “Calm” is not a rule; the spacing, type, color, hierarchy, and motion decisions that create calm are rules.
  • Never copy protected assets, brand marks, or prose.
  • One reference produces a provisional grammar. Say so and keep confidence low where warranted.
  • The generated grammar is project-local. Do not edit
    RULESETS.md
    or publish it as built-in.
  • Core invariants and accessibility remain non-negotiable.
  • 优先可见证据,而非形容词。“平静”不是规则;创造平静感的间距、字体、颜色、层级和动效决策才是规则。
  • 切勿复制受保护的资产、品牌标识或文案。
  • 单个参考内容生成临时语法。请明确说明这一点,并在必要时保持低置信度。
  • 生成的语法是项目本地的。请勿编辑
    RULESETS.md
    或将其发布为内置语法。
  • 核心不变量和可访问性是不可协商的。