用途
ss-build 用于按照 StyleSeed 的组合式方法（composed method）构建或重建一个界面（screen），并在向用户展示之前依次通过代码门禁与像素门禁。它适用于需要构建或重建界面的场景。
主要能力
- 在代码之前先建立规则集，确保设计判断有据可依。
- 采用注册表优先的 artifact 边界：当 .styleseed/project.json 与 .styleseed/artifacts/index.json 存在时，先解析请求的 artifact ID，然后只读取 .styleseed/bundles/<artifact-id>.md 与 .styleseed/manifests/<artifact-id>.json。
- 支持旧版路径：仅当两个注册表文件都不存在时，若 STYLESEED.md 缺失则先运行 /ss-setup，否则保留它；调用 /ss-resolve（Claude Code）或 $ss-resolve（Codex），读取 .styleseed/effective-rules.md 并保留 .styleseed/manifest.json。
- 组合而非即兴：编译后的 bundle 已按权威顺序组合（核心不变量 → 所选语法 → 表面适配器 → 领域/页面 → 品牌配方 → 可选 profile → 有界锁 → 工艺基线）。
- 代码门禁：对实际实现运行 /ss-score，评分需指明有效规则集并检查核心不变量与语法特定特征，最多三轮修正，达到 ≥80 可提前停止。
- 像素门禁：对每个可渲染 artifact 调用 /ss-verify，使用适配器渲染器检查每个必需视口/帧/页面及相关状态，修复感知失败并重新渲染。
- 最终以证据展示：报告有效规则集及适配理由、最终代码评分、视觉验证状态与视口、门禁带来的实质修复、项目/artifact 配置路径（或旧版 STYLESEED.md）及任何编译语法路径。
使用方式
- 前置：遵循每会话一次的更新预检（update preflight）。
- 建立规则集：若存在注册表文件，使用已安装解析器的 scripts/resolve-context.mjs --project-root . --artifact <artifact-id> --agent <agent> 解析请求的 artifact，读取 bundle 并保留 manifest 作为来源凭据；不要因注册表不完整、无效或缺少编译输出而创建 STYLESEED.md、重启设置或使用旧版 bundle。跨多个 artifact 的变更需分别解析与检查每个受影响的 artifact。仅当两个注册表文件都不存在时走旧版路径。
- 若提供的视觉参考未被所选语法表示，在所选项目边界内使用 /ss-reference；不得将不熟悉的参考简化为调色板替换，也不得未经人工批准替换已批准的项目选择。解析成功后不要加载 llms-full.txt。
- 组合：使用 manifest 选择与源哈希检测漂移；仅当 bundle 指向真正的歧义时才打开完整源文档。代码前用一行声明有效规则集，例如：operations-console × SaaS × dashboard × enterprise-workbench × swiss × locked brand tokens。按权威解决冲突；profile 或锁不能豁免任务适配性、一致性或可访问性。
- 以设计判断构建：在首个视口呈现语法的用户任务与主要决策；建立一个焦点，避免等权模板网格；使用语法的组合、密度、字体、颜色、表面、图像/数据、动作、状态、响应式与动效契约；使用配方的容纳、几何、控件、集合与导航形态；使用捆绑模式组件时在 artifact 根设置 data-styleseed-recipe="<id>"；使用产品特定内容与证据，绝不复制 StyleSeed 演示或参考界面；在相关处实现加载、空、错误、焦点、减少动效与响应式行为。
- 间距工作：使用解析器的空间角色指南，在选择间隙前阅读任何编译的间距部分，将其作用域变量映射到现有组件并保留未声明的角色；有意识地分组相关内容，不要为达到密度而增加嵌套内边距或缩小字体；实现必须消费这些变量，仅配置不会改变渲染布局。
- 代码门禁循环：对交互工作，在测试前命名所需的用户结果（例如保存的设置重载后仍存在、保存失败保留草稿、查看者不能执行编辑操作）；复用项目真实实现与测试工具，断开的演示或源文本断言不能证明动作有效。注册表构建将适用结果记录为 artifact 中的 validation.functional.scenarios，并用 implementation.sourceRoots 覆盖测试及其实现依赖；使用已安装的 ss-score 参考 references/functional-checks.md 运行并保留证据。失败、跳过、缺失或未执行的必需场景会阻止完成，即使代码评分很高。若可用运行器无法执行项目，报告确切的未验证结果，不要为获得通过而省略其要求。静态 artifact 可省略功能场景并附明确的 not-applicable 说明。对实际实现运行 /ss-score，修复最高收益失败并重新评分，最多三轮修正，≥80 提前停止；优先处理损坏流程与核心失败，再考虑可选评分增益。若无法通过，报告实际评分与剩余失败，不要通过调用不同技能重启通过预算。
- 像素门禁循环：对每个可渲染 artifact 调用 /ss-verify，使用适配器渲染器检查每个必需视口/帧/页面及相关状态，修复感知失败并重新渲染。若无可用渲染器，说明视觉门禁被跳过，绝不要暗示其通过。
- 以证据展示：报告有效规则集及适配理由、最终代码评分、视觉验证状态与视口、门禁带来的实质修复、项目/artifact 配置路径（或旧版 STYLESEED.md）及任何编译语法路径。
适用场景
- 构建或重建界面（screen）时。
- 需要按 StyleSeed 组合式方法确保设计规则先于代码的场景。
- 需要代码评分与视觉验证双重门禁的 UI 开发流程。
限制
- 注册表项目绝不回退到全局旧版 bundle；旧版项目仅在没有注册表时使用 .styleseed/effective-rules.md。
- 不得因注册表不完整、无效或缺少编译输出而创建 STYLESEED.md、重启设置或使用旧版 bundle；缺失范围需与用户解决。
- 不得将不熟悉的参考简化为调色板替换，不得未经人工批准替换已批准的项目选择。
- 解析成功后不要加载 llms-full.txt。
- 评分与截图是辅助证据，不是设计判断的来源。
- 主要动作必须保持可识别；额外颜色仅在语法赋予其稳定语义或分类含义处允许。
- 每次 UI 变更都要重新阅读锁与语法。
- 若可用运行器无法执行项目，需报告确切的未验证结果，不得为通过而省略要求。
- 若无可用渲染器，视觉门禁视为跳过，不得暗示通过。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。