Agent Skillsbitjaru/styleseed › ss-build

ss-build

GitHub

基于StyleSeed方法论构建UI屏幕,通过确立规则、组合语法、代码评分及像素级验证闭环,确保设计一致性与高质量交付。

engine/.claude/skills/ss-build/SKILL.md bitjaru/styleseed

Trigger Scenarios

需要按照特定设计规范生成前端界面 执行StyleSeed构建流程以验证UI质量

Install

npx skills add bitjaru/styleseed --skill ss-build -g -y
More Options

Non-standard path

npx skills add https://github.com/bitjaru/styleseed/tree/main/engine/.claude/skills/ss-build -g -y

Use without installing

npx skills use bitjaru/styleseed@ss-build

指定 Agent (Claude Code)

npx skills add bitjaru/styleseed --skill ss-build -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-build",
    "description": "Build a screen with StyleSeed's composed design method — choose or compile an output grammar, apply domain\/page\/profile\/lock constraints, then run the code and pixel gates before presenting.",
    "allowed-tools": "Read, Write, Edit, Grep, Glob, Bash, WebFetch",
    "argument-hint": "[what to build]"
}

Build with the composed StyleSeed method

The build method is the product. Score and screenshots are auxiliary evidence, not the source of design judgment.

Step 1 — Establish the rule set before code

If STYLESEED.md does not exist, run /ss-setup and write it before UI code. If the user supplied a visual reference that the selected built-in grammar does not capture, run /ss-reference first. Never reduce an unfamiliar reference to a palette swap.

Then invoke /ss-resolve (Claude Code) or $ss-resolve (Codex), or run its bundled scripts/resolve-context.mjs --project-root . --from-lock STYLESEED.md --agent <agent>. Read .styleseed/effective-rules.md and preserve .styleseed/manifest.json as the provenance record. Do not load llms-full.txt after resolution succeeds.

Step 2 — Compose, do not improvise

The compiled bundle already composes the authority order: core invariants → selected grammar → surface adapter → domain/page → optional profile → bounded lock → craft baseline. Use the manifest selection and source hashes to detect drift. Open a full source document only when the bundle points to a genuine ambiguity; do not reassemble the handbook ad hoc.

Before code, state the effective rule set in one line, for example:

operations-console × SaaS × dashboard × swiss × locked brand tokens

Resolve conflicts by authority. A profile or lock cannot waive task fitness, coherence, or accessibility.

Step 3 — Build with design judgment

  • Make the grammar's user job and primary decision visible in the first viewport.
  • Establish one focal point; avoid equal-weight template grids.
  • Use the grammar's composition, density, type, color, surface, imagery/data, action, state, responsive, and motion contracts.
  • Use product-specific content and evidence. Never copy the StyleSeed demo or a reference screen.
  • Implement loading, empty, error, focus, reduced-motion, and responsive behavior where relevant.

Step 4 — Code gate loop

Run /ss-score on the actual implementation. The score must name the effective rule set and check both core invariants and grammar-specific tells. Fix the highest-gain failures and re-score, up to roughly three passes, until ≥80. If it cannot pass, report the real blocker.

Step 5 — Pixel gate loop

For every renderable artifact, invoke /ss-verify: use the adapter renderer, inspect every required viewport/frame/page and relevant state, fix perceptual failures, and re-render. If no renderer is available, say the visual gate was skipped; never imply it passed.

Step 6 — Present with proof

Report:

  • effective rule set and why it fits;
  • final code score;
  • visual verification status and viewport;
  • material fixes made by the gates;
  • STYLESEED.md and any compiled grammar path.

Rules

  • Grammar before code; code gate after build; pixel gate last.
  • Output grammar is functional. Aesthetic profile is optional and never substitutes for it.
  • The primary action must remain identifiable; additional color is permitted only where the grammar gives it stable semantic or categorical meaning.
  • Re-read the lock and grammar on every UI change.

Version History

  • 0e2cb9a Current 2026-08-01 05:37

    优化Step 1规则建立逻辑,引入scripts/resolve-context.mjs脚本进行上下文解析,简化了文件读取依赖,强调使用manifest.json作为溯源记录。

  • 2ec6162 2026-07-19 22:38

Same Skill Collection

engine/.claude/skills/ss-a11y/SKILL.md
engine/.claude/skills/ss-audit/SKILL.md
engine/.claude/skills/ss-component/SKILL.md
engine/.claude/skills/ss-copy/SKILL.md
engine/.claude/skills/ss-dial/SKILL.md
engine/.claude/skills/ss-feedback/SKILL.md
engine/.claude/skills/ss-flow/SKILL.md
engine/.claude/skills/ss-lint/SKILL.md
engine/.claude/skills/ss-motion/SKILL.md
engine/.claude/skills/ss-page/SKILL.md
engine/.claude/skills/ss-pattern/SKILL.md
engine/.claude/skills/ss-reference/SKILL.md
engine/.claude/skills/ss-resolve/SKILL.md
engine/.claude/skills/ss-restyle/SKILL.md
engine/.claude/skills/ss-review/SKILL.md
engine/.claude/skills/ss-score/SKILL.md
engine/.claude/skills/ss-setup/SKILL.md
engine/.claude/skills/ss-tokens/SKILL.md
engine/.claude/skills/ss-update/SKILL.md
engine/.claude/skills/ss-verify/SKILL.md
skills/styleseed-design-review/SKILL.md

Metadata

Files
0
Version
0e2cb9a
Hash
153f2ce4
Indexed
2026-07-19 22:38

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-05 00:49
浙ICP备14020137号-1 $방문자$