Repository navigation
A generated brand is now checked against what it actually renders, and the health check reports refuted structural directions instead of passing over them. Nothing breaks: the audit script's exit codes are unchanged.
Install
/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz
No Claude Code marketplace? Download ui-contract-0.3.4.zip below — its README covers both install paths, including install.sh for other agents' skill directories.
What changed since 0.3.3
ui-contract-design — originating a brand (ADR-0017)
- Tear down real references first. Before the three directions are offered, two or three real products in the category are taken apart and recorded in
design.md§1 — what was kept, what was deliberately broken. The look-alike checks now run against those instead of a thought experiment. - Vague words get translated. An aesthetic adjective ("cleaner", "more premium") has to become the token group it moves and one observable decision.
- The tuning session has a close. A fixed visual baseline (the prototype wall, a 480px frame, 200% crops of the two densest controls), a three-second check on it, then one context-free review that reports whether the surface still reads as the chosen direction. The review can be skipped, but a skip is written into §1 rather than left silent.
- Motion states its basis. §8 values say where they come from — the product's state rhythm, the platform's convention, the signature treatment — or are marked as the weakest section.
ui-contract-audit — the health check
- Check 10 now lifts refuted (⛔) rows verbatim, separately from pending (⏳) ones. Before, it could not see them at all.
- The report ends with a machine-readable
AUDIT-JSONline: pass / skip / fail for each check, and the warning count. The prose report and the exit codes are unchanged.
Other
- The
ui-contractskill no longer carries a staleversion: "0.2.0";plugin.jsonis the one version. - Development only (not in the zip): CI now runs the same
./testing/run.shmaintainers run locally, and the repository gained a security policy and issue / pull request templates.
中文说明
生成品牌(ui-contract-design):
- 提出三个方向之前,会先拆解两三个同类的真实产品作为参照。
- 「更干净」「更高级」这类形容词,必须翻译成具体要动的颜色、间距等设计变量(token),以及一个看得见的决定。
- 调校收尾时会截一组固定的对照图,做一次「看三秒」检验,再请一个不知道前情的评审者判断:结果还像不像当初选的方向。评审可以跳过,但跳过要写进 design.md。
- 动效数值必须写明依据。
体检(ui-contract-audit):第 10 项检查现在会把「已被否决的方向(⛔)」原样列出来,以前完全看不到;报告末尾新增一行机器可读的汇总。退出码不变,不影响现有的 CI。
ui-contract-0.3.4.zip · SHA-256 ba8d08fcd4bb877b0d25b27fd20e6f6d3ba347905f48da771b9a756f017a828b