ss-resolve
GitHub根据 STYLESEED.md 或显式参数,编译生成确定性的 StyleSeed 规则包(语法、适配器、调色板等)。支持从锁文件解析或手动指定配置,用于在构建前确定设计上下文,避免加载完整手册。
Trigger Scenarios
Install
npx skills add bitjaru/styleseed --skill ss-resolve -g -y
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.mdwhen 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
cdinto the skill directory. - Legacy single-artifact projects should prefer
--from-lock STYLESEED.md. Registry projects use.styleseed/project.jsonplus.styleseed/artifacts/*.jsonand must resolve with--artifactor--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
--checkto 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.
Version History
-
bfd06d8
Current 2026-08-19 16:27
新增 artifact-bound StyleSeed 验证功能 (feat(runtime): add artifact-bound StyleSeed verification)
-
c414969
2026-08-13 14:11
新增生成式语义调色板引擎,支持 OKLCH 颜色生成及 palette.json/css 输出,增强色彩自适应能力。
-
1a00699
2026-08-07 00:37
新增 StyleSeed Studio 和语义调色板引擎,支持 --palette auto 自动映射对比度验证的语义调色板。
-
e0a0991
2026-08-05 10:46
新增品牌配方形态引擎 (brand recipe morphology engine)
- 0e2cb9a 2026-08-01 05:38


