Files
JX-BPOS/.claude/skills/html-one-pager/references/uipm-recipes.md
T
ChaiHaoandClaude Opus 5 ade0fa5a94 A2-A7 全部补齐到验收线;顺手把几处「门拦住却不给路」的坑填了
活动:A2 选型 / A3 寻源 / A4 定价 / A6 议价 / A7 归档五件各补成真活动包 ——
契约宽进(input.required 空,归一在活动内)、台账必填声明(含行级 requiredWhen)、
入场哨兵与 L1/L2 判据一律读基座数、两份件(在办可编辑 + 办结静态快照)、
三案例常备、包内自测。e2e 各三案例 released、行动被拒 0、发口正确、提交闸每单真拦。

基座(共享面,改一处影响所有活动,故每处都带回归):
· 重发判断走在站上场之前 —— 人答完那步常已收掉,readyToWork 先抛「不能再往它上面挂活」,
  于是「重发已答过的卡 = 无事发生」这条唯一活路在最需要时够不着,A1 基线当场熔断;
· 决策卡补幂等兜底(与执行工单同一把尺):头两次无事发生,第三次起才算被拒;
· 输出没成形先就地重问一次,原话进工作日志、不再摆上卡面;
· 工具调用读数 tool_<名>_calls —— 「机检只读基座数」这条纪律第一次覆盖到工具;
· 执行卡 steps/standard 补进出参 schema(从前能到卡面全靠厂商 JSON 模式宽松);
· 件的就地更新改逐节点 morph,保存先把新值镜像进只读那份 —— 不闪、不等回声。

A1(基线,全程守住):措辞三档对齐(必填/建议/选填)、禁止拿历史价当客户目标价、
卡骨架从步骤剧本搬进说明书(压成一拍连做时剧本没摊开,会发出没有指导书的裸卡)。

契约两处**新增可选字段**(非破坏):FieldDeclaration.requiredWhen、工单 finalHtml;
api-report 同批更新。docs/adr 与 docs/archive 的 13 份文件在工作树里不见了,
本次予以恢复而非提交删除。

门禁:typecheck / lint / depcruise / test(1366)全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 12:28:31 +08:00

2.8 KiB

ui-ux-pro-max 查询菜谱

ui-ux-pro-max 是本机的插件技能:一个 BM25 检索的本地设计库(84 风格 / 192 配色 / 74 字体对 / 98 UX 守则 / 104 图标 / 25 图表)。我们只用它的查询脚本拿设计方向, 不装载它的整套工作流——它的持久化步骤会往仓库写文件,字体/动效建议也与 JCAI 契约相抵,见下面的过滤表。

定位与调用

UIPM=$(ls -d ~/.claude/plugins/cache/ui-ux-pro-max-skill/ui-ux-pro-max/*/.claude/skills/ui-ux-pro-max 2>/dev/null | sort -V | tail -1)
python3 "$UIPM/scripts/search.py" "<query>" --design-system -p "<件名>" --density 7

缺席兜底:$UIPM 为空(插件没装/被移除)时不装死——按「A1 版面语言 + 中高密度」 的默认继续走,并在交付说明里写一句「设计库缺席,走了默认」。

查询配方

场景 query 建议 旋钮
执行页(密表核对) enterprise b2b workflow document review data table form --density 7(仪表密度,信息多)
验收/归档页(仪式感) invoice quotation official document archive certificate --density 5 --variance 4
汇报/对比 slide executive summary comparison dashboard presentation --density 6 --variance 6
单域深挖 UX --domain ux + form table dense data review -n 5
单域深挖版面风格 --domain style + editorial minimal document swiss -n 5

0 结果:换一次关键词;仍空就走默认并明说,不编造「数据库推荐」。

三不用(命令行层面)

  • --persist / --output-dir:会往仓库写 design-system/<slug>/MASTER.md —— 污染仓库
  • --motion:产出 GSAP JS 片段,而目标件零脚本
  • --stack:我们不是在选框架,产物是纯 HTML/CSS

五不取 · 四要取(结果层面)

它给的 取舍 为什么
字体对 + Google Fonts 外链 不取 目标件零外链;字体族固定 PRD_CSS 系统栈(Inter…PingFang SC)
配色替换 不取 JCAI 家族令牌零改动(--brand #3370ff 等);v-* 语义色承载判定语义
GSAP/JS 动效 不取 零脚本。可译成纯 CSS 的意图(时长/缓动)可参考,且已有 reduced-motion 守卫
图标库引用 不取 一律 PRD_SPRITE 内联 symbol(见 block-catalog)
任何 CDN/外部资源 不取 安装门与自检都拦
版面构图(分栏/bento/层级) 取 这正是要它出的「精美组件布局突出结构」
组件形制(卡/带/表头/徽章的形) 取 译成 JCAI 令牌下的 CSS
密度/留白档 取 执行页密、归档页缓
UX 守则(对比度/触达面积/反馈位置) 取 出稿前对照检查

取的东西只进脑子,不落盘——查询结果不存文件,消化成设计决定写进件里。