Agent Skills › bitjaru/styleseed › ss-resolve

ss-resolve

GitHub

解析并编译 StyleSeed 规则包，生成确定的设计上下文（语法、适配器、领域等）。用于在配置变更或构建前替代加载完整手册，支持锁定文件与注册表模式，确保设计系统一致性。

skills/ss-resolve/SKILL.md bitjaru/styleseed

Trigger Scenarios

STYLESEED.md 发生变更时需要更新 StyleSeed 配置时 Agent 构建或设置前需加载精简规则包时

Install

npx skills add bitjaru/styleseed --skill ss-resolve -g -y

More Options

Use without installing

npx skills use bitjaru/styleseed@ss-resolve

指定 Agent (Claude Code)

npx skills add bitjaru/styleseed --skill ss-resolve -a claude-code -g -y

安装 repo 全部 skill

npx skills add bitjaru/styleseed --all -g -y

预览 repo 内 skill

npx skills add bitjaru/styleseed --list

SKILL.md

Frontmatter

{
    "name": "ss-resolve",
    "description": "Compile a small, deterministic StyleSeed rule bundle for one agent, output grammar, surface adapter, domain, page type, brand recipe, palette recipe, and optional profile. Use before setup or build, when STYLESEED.md changes, when updating StyleSeed, or whenever an agent would otherwise load the full rule handbook."
}

Resolve effective StyleSeed context

Use the bundled scripts/resolve-context.mjs; do not hand-compose the rule stack.

Read STYLESEED.md when it exists. Confirm missing required selections with the user.
Keep the working directory at the user's project root. Invoke the script by its installed path; do not cd into the skill directory.
Legacy single-artifact projects should prefer --from-lock STYLESEED.md. Registry projects use .styleseed/project.json plus .styleseed/artifacts/*.json and must resolve with --artifact or --all; in registry mode, edit project-owned config instead of passing selection overrides.
Read the emitted bundle before building: legacy writes .styleseed/effective-rules.md; registry writes .styleseed/bundles/<artifact-id>.md.
Preserve the manifest output: legacy uses .styleseed/manifest.json; registry uses .styleseed/manifests/<artifact-id>.json.
Use --check to detect context drift without rewriting files.

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

Registry project:

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

Without a lock:

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

Use --list to print supported IDs. --recipe auto maps the selected grammar to a maintained default; --palette auto maps that recipe to a contrast-verified semantic palette. Pass explicit values when the product needs a different morphology or color posture. The default output directory is .styleseed/ in the project root. For a project-local reference grammar, pass reference:<slug> and ensure .styleseed/rulesets/<slug>/RULESET.md exists. Registry projects require the full six-file reference contract: RULESET.md, tokens.json, evidence.json, checks.md, reference-board.html, and adapter.json.

When a key color is present in flags or the lock, the resolver uses the shared OKLCH generator and writes .styleseed/palette.json plus .styleseed/palette.css. The manifest records the generation inputs. The maintained recipe still supplies product posture and semantic restrictions; its fixed hex values become fallbacks rather than overriding the generated system.

Do not load llms-full.txt after a bundle resolves successfully. Load a larger source document only when the bundle names an unresolved ambiguity that requires it.