mcpField
S
ss-resolve

ss-resolve

github.com/bitjaru设计与 UI993571 次安装1 天前更新
代码仓库

关于 ss-resolve

ss-resolve 是用于 StyleSeed 项目的设计上下文解析技能，面向需要加载和检查项目规则的工作流。它按项目注册表或旧版锁文件解析规则，并保留清单与证据状态。

主要功能

  1. 01解析注册表或锁文件中的规则
  2. 02生成有效规则包与清单
  3. 03检查规则上下文是否漂移
  4. 04诊断项目配置与证据状态
  5. 05生成语义色板文件

适用场景

  1. 01开始设计工作前加载项目规则
  2. 02检查指定工件的当前证据
  3. 03为旧版项目迁移评估做只读诊断

安装

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

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

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
artifact-index.schema.json
artifact.schema.json
catalog.json
manifest.schema.json
migration.md
project.schema.json
spacing.md
scripts/
compiler.mjs
distribution-integrity.mjs
legacy-lock-analysis.mjs
migrate-project.mjs
palette-generator.mjs
project-registry.mjs
recommend-spacing.mjs
resolve-context.mjs
runtime-contract.mjs
spacing-contract.mjs
spacing-measurement.mjs
styleseed-doctor.mjs

详细介绍

在此工作流之前，请先按照会话内仅需执行一次的更新前置检查操作。

解析有效的 StyleSeed 上下文

使用随附的 scripts/resolve-context.mjs；不要手动拼接规则栈。

  1. 首先确定项目边界：如果 .styleseed/project.json 或 .styleseed/artifacts/index.json 任一文件存在，则必须使用完整且有效的注册表。注册表出错时，不要回退到 STYLESEED.md。仅当注册表不存在时，才使用该锁定文件。
  2. 将工作目录保持在用户的项目根目录。通过脚本的安装路径调用脚本；不要 cd 到技能目录。
  3. 旧版单产物项目应优先使用 --from-lock STYLESEED.md。注册表项目使用 .styleseed/project.json 和 .styleseed/artifacts/*.json，并且必须通过 --artifact 或 --all 解析；在注册表模式下，应编辑项目自有配置，而不是传递选择覆盖项。
  4. 构建前读取生成的规则包：旧版会写入 .styleseed/effective-rules.md；注册表模式会写入 .styleseed/bundles/<artifact-id>.md。
  5. 保留清单输出：旧版使用 .styleseed/manifest.json；注册表模式使用 .styleseed/manifests/<artifact-id>.json。
  6. 使用 --check 检测上下文漂移，但不要重写文件。

有关间距建议和范围控制，请参阅空间角色指南。 可选的项目级／产物级 spacing 会编译为角色表和规则包中限定于产物的 CSS。 recommend-spacing.mjs --project-root . --artifact <id> 会生成只读的初步建议；它不会检查或重写实现令牌，也不会确认设计已获认可。可选的 --measurement <project-relative-report.json> 会添加与源文件绑定的渲染诊断；过时或不一致的报告会被拒绝，且初始值会明确标注为启发式估算。

如有安装或项目健康状况方面的问题，请先运行只读诊断：

如果用户要求从旧版迁移到注册表，请先检查 migrate-project.mjs --dry-run。 请按照经审查的迁移指南了解计划格式和应用顺序。 不带参数的 --write 会有意拒绝未经审查的默认值。应用迁移需要完整且经人工审查的计划、当前锁定文件哈希、一对一的章节到产物映射，以及与该计划确切哈希匹配的 --confirm-plan。架构有效或试运行成功，并不代表设计决策已得到保留；绝不要根据诊断请求推断用户已批准迁移或执行写入操作。

node <installed-ss-resolve>/scripts/styleseed-doctor.mjs --project-root . --json

它会根据当前输入检查本地分发清单、项目配置、已编译规则和已存储证据。使用 --artifact <id> 可缩小注册表检查范围。它绝不会设置、迁移、重新编译、渲染或更新项目。仅在用户授权范围内执行其 next 操作。退出码 0 表示所有选定产物的证据均为最新；这不代表独立的视觉评估。退出码 1 表示需要关注；退出码 2 表示调用无效。旧版项目的规则可以是最新的，但证据仍可能处于 unsupported 状态。安装完整性并不能证明宿主已发现该工具、发布者身份真实，或项目使用的是最新上游版本。

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --from-lock STYLESEED.md \
  --agent codex

注册表项目：

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --project-root . \
  --artifact app-dashboard \
  --agent codex

没有锁定文件时：

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --agent claude \
  --grammar operations-console \
  --adapter product-ui \
  --domain saas \
  --page dashboard \
  --recipe enterprise-workbench \
  --palette cobalt-instrument \
  --key-color "#175CD3" \
  --palette-character balanced \
  --palette-mode light \
  --palette-harmony auto \
  --surface-temperature cool \
  --profile swiss

使用 --list 打印支持的 ID。--recipe auto 会将所选语法映射到维护中的默认方案；--palette auto 会将该方案映射到经过对比度验证的语义调色板。如果产品需要不同的形态或配色取向，请传入明确的值。默认输出目录为项目根目录中的 .styleseed/。对于项目本地的参考语法，请传入 reference:<slug>，并确保 .styleseed/rulesets/<slug>/RULESET.md 存在。注册表项目需要完整的六文件参考契约：RULESET.md、tokens.json、evidence.json、checks.md、reference-board.html 和 adapter.json。 当 flags 或锁文件中存在关键颜色时，解析器会使用共享的 OKLCH 生成器，并写入 .styleseed/palette.json 和 .styleseed/palette.css。清单会记录生成输入。维护中的配方仍负责提供产品定位和语义限制；其中固定的十六进制值将作为回退值，而不是覆盖生成的系统。

Bundle 成功解析后，不要加载 llms-full.txt。只有当 bundle 指出存在尚未解决且需要查阅的歧义时，才加载更大的源文档。

评论

支持 Markdown