mcpField
S
ss-reference

ss-reference

github.com/bitjaru设计与 UI993706 次安装今天更新
代码仓库

关于 ss-reference

将给定设计参考编译为项目本地规则和产物的工作流技能。它指导收集证据、处理参考之间的冲突，并在代表性界面上验证生成的设计语法。

主要功能

  1. 01为参考资料分配证据 ID
  2. 02按十二个维度观察
  3. 03解决参考间的冲突
  4. 04编译项目本地规则
  5. 05验证代表性界面

适用场景

  1. 01从给定参考界面归纳设计规则
  2. 02为不同产品界面分别编译参考
  3. 03检查提炼出的设计语法能否迁移到其他界面

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bitjaru/styleseed --skill ss-reference

安装后在 Claude Code 中输入/ss-reference确认已加载。

详细介绍

在此工作流之前，请遵循仅需每个会话执行一次的 更新前置检查。

将参考资料编译为设计语法

以注册表为先的工件边界

当 .styleseed/project.json 和 .styleseed/artifacts/index.json 存在时，请先解析请求的工件 ID，然后仅读取 .styleseed/bundles/<artifact-id>.md 和 .styleseed/manifests/<artifact-id>.json。对于注册表项目，绝不要回退到全局旧版套件。仅当不存在注册表时，旧版项目才可使用 .styleseed/effective-rules.md。

不要只是模仿提供的屏幕。请阅读 PRODUCT-PRINCIPLES.md、RULESETS.md、 ADAPTERS.md 和 REFERENCE-COMPILER.md，然后完整执行编译器流程。

工作流

  1. 接收所有提供的参考资料，并分配证据 ID（R1、R2，……）。如果 URL 可渲染，请进行截图。如果无法查看某张图片，请停止声称对其进行了视觉分析。
  2. 按界面适配器和用途区分参考资料。除非用户明确希望将两种语言联系起来，否则不要将营销首页与应用仪表盘合并。
  3. 观察并测量十二个维度。每条规则都要注明证据 ID 和置信度。
  4. 解决矛盾，而不是取平均值。简要说明任何重要取舍。
  5. 选择最接近的内置回退语法和适配器，然后按照 REFERENCE-COMPILER.md 的要求，在 .styleseed/rulesets/<slug>/ 下编译项目工件。
  6. 对于注册表项目，在所选工件的项目配置中选择 reference:<slug>；仅当两个注册表文件都不存在时，才更新旧版 STYLESEED.md。保留有界品牌选择。注册表不完整或无效时应视为错误，不能回退。
  7. 验证迁移效果：将该语法应用于源资料集中没有的一张代表性屏幕，运行 /ss-score，然后在可渲染时运行 /ss-verify。在授权的验证范围内，修复并重复验证，直到通过，或每个关卡完成三轮修正；委派的轮次也计入。不要通过切换技能重置次数预算；报告实际分数和未解决的问题。
  8. 报告已学到的内容、仍然置信度较低的部分、工件所在位置以及验证结果。

规则

  • 先看可见证据，再用形容词。“平静”不是一条规则；营造平静感的间距、字体、颜色、层级和动效决策才是规则。
  • 绝不要复制受保护的资产、品牌标识或文案。
  • 一份参考资料只能生成暂定语法。请明确说明这一点，并在适当情况下保持较低的置信度。
  • 生成的语法属于项目本地内容。不要编辑 RULESETS.md，也不要将其发布为内置语法。
  • 核心不变量和无障碍要求不可妥协。

评论

支持 Markdown