le-app-design v1.1.0:阶段顺序修正——frontend-design 先定方向,ui-ux-pro-max 后编系统(方向由题材与 POV 决定,不由品类目录决定)。依据四条:①pro-max 自身 Step 1 契约即期望风格关键词作为输入;②impeccable craft-floor 原文 direction settled 后才施工;③两次实跑实证系统先行产出品类默认脸(cream 命中 detect tell / Tailwind 默认靛蓝被评审点名),frontend-design 两遍法被迫做防守性裁决;④专业流程方向先于系统。新增两补丁:硬约束否决权(改值不改方向)与目录回弹降级(51 风格目录匹配失败时用 design-plan token 表 + pro-max 逐项校验);S2 可选调研模式(--domain 检索当情绪板,不做决定);停点2 补 impeccable critique 的 Questions skipped 字面行硬规则(上次审计发现的契约遗漏)
This commit is contained in:
@@ -27,46 +27,46 @@ python3 <SKILL>/scripts/check_deps.py --out <RUN>/deps.json
|
||||
|
||||
**验收**:BRIEF.md 落盘,模式归属有理由。
|
||||
|
||||
## S2 设计规范 — ui-ux-pro-max
|
||||
## S2 视觉探索 — frontend-design(方向先行)
|
||||
|
||||
**动作**
|
||||
```bash
|
||||
# 主调用:生成并持久化设计系统(MASTER.md 是后续 token 的唯一来源)
|
||||
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-design-system -- \
|
||||
python3 <DEP_UIUX>/scripts/search.py "<产品类型> <行业> <2-3 风格关键词>" \
|
||||
--design-system --persist -p "<项目名>" --output-dir <项目根>
|
||||
1. 宿主有 Skill 工具 → 调它装载 `frontend-design`;没有 → Read `<DEP_FD>/SKILL.md` 全文(两路等价,装载即调用)。
|
||||
2. 立即记账:`python3 <SKILL>/scripts/log_call.py frontend-design --run-dir <RUN> --note S2-load --load <DEP_FD>/SKILL.md`
|
||||
3. 以其「设计总监」立场产出 `<RUN>/design-plan.md`:
|
||||
- **题材世界**:从产品自己的世界取材(subject matter 是差异化来源),写明方向一句话
|
||||
- **色板**:4–6 个具名 hex(`--纸面 #FDFDF8` 式命名)
|
||||
- **字体**:选型 + 角色,说明为何不是默认脸
|
||||
- **布局**:一句话概念 + 每屏 ASCII 线框 + 对齐策略
|
||||
- **原则**:这个产品独有的 3–5 条
|
||||
- **两遍法第二遍**:对照其「AI 味特征清单」逐条自检;发现默认味 → 写明改了什么、为什么
|
||||
4. (可选调研模式)方向成形前可用 pro-max `--domain style|color|typography` 检索选项当情绪板(记账 note=S2-research)——**只供参考不做决定**,此阶段禁止 `--design-system`。
|
||||
|
||||
# 定向补充(按需,每次独立记账):
|
||||
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-ux -- \
|
||||
python3 <DEP_UIUX>/scripts/search.py "<关注点,如 bottom nav touch target>" --domain ux
|
||||
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-stack -- \
|
||||
python3 <DEP_UIUX>/scripts/search.py "<实现关键词>" --stack html-tailwind
|
||||
**验收**:design-plan.md 四要素齐全 + 自检一节存在 + 记账在案;方向不来自品类匹配。
|
||||
|
||||
## S3 设计规范 — ui-ux-pro-max(系统后行)
|
||||
|
||||
**动作**:把已定方向编撰成规范 + 硬约束校验:
|
||||
|
||||
```bash
|
||||
# 主调用:用方向关键词(不是品类词)驱动系统生成;dials 按方向调
|
||||
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S3-design-system -- \
|
||||
python3 <DEP_UIUX>/scripts/search.py "<方向关键词>" --design-system --persist \
|
||||
-p "<项目名>" --output-dir <项目根> [--variance N --motion N --density N]
|
||||
|
||||
# 硬约束校验(按需,全部记账):对比度/触控/排版/相关 UX 规则
|
||||
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S3-ux-check -- \
|
||||
python3 <DEP_UIUX>/scripts/search.py "<如 contrast touch target>" --domain ux
|
||||
```
|
||||
|
||||
遵守上游 Query Contract:一次查询一个主导意图、2–5 个有效词;结果空/跑题重试一次更窄的写法,再不行如实说「无验证匹配」。
|
||||
**两条规则**:
|
||||
- **硬约束否决权**:frontend-design 定的 hex/字号若不达标(WCAG/HIG/MD 数据为准),**改值不改方向**;每处修改记入 design-plan 决策记录。
|
||||
- **目录回弹降级**:pro-max 风格目录(51 个活跃风格)若对已定方向匹配失败——生成结果明显回弹到品类默认(拿 tell 清单对:cream 底、默认靛蓝、SaaS 卡组等)——则**不采用该 MASTER**,降级为「design-plan 的 token 表即规范 + pro-max 逐项校验补硬约束」,决策记录写明降级理由。方向的独特性优先于系统的便利性。
|
||||
|
||||
**产物**:`<项目根>/design-system/<slug>/MASTER.md`(+ 查询输出摘要)。
|
||||
|
||||
**验收**:MASTER.md 存在且 calls.jsonl 有 exit=0 的 S2 记录。已有 MASTER.md 时上游默认跳过覆盖——读它再决定是否需要 `--force`(须用户同意)。
|
||||
|
||||
## S3 视觉探索 — frontend-design
|
||||
|
||||
**动作**
|
||||
1. 宿主有 Skill 工具 → 调它装载 `frontend-design`;没有 → Read `<DEP_FD>/SKILL.md` 全文(两路等价,后者不是降级——装载即调用)。
|
||||
2. 立即记账:`python3 <SKILL>/scripts/log_call.py frontend-design --run-dir <RUN> --note S3-load --load <DEP_FD>/SKILL.md`
|
||||
3. 以其「设计总监」立场产出 `<RUN>/design-plan.md`:
|
||||
- **色板**:4–6 个具名 hex(`--bg-deep #0E1B2C` 这样命名)
|
||||
- **字体**:选型 + 各自角色(display/body/数字…),说明为何不是默认脸
|
||||
- **布局**:一句话概念 + 每屏 ASCII 线框 + 对齐策略
|
||||
- **原则**:这个产品独有的 3–5 条,从题材世界取材(frontend-design:subject matter 是差异化来源)
|
||||
- **两遍法第二遍**:对照其「AI 味特征清单」(cream+terracotta、暗底酸绿、报纸 hairline、SaaS 卡片套件、eyebrow/中点连接串等)逐条自检;发现默认味 → 写明改了什么、为什么
|
||||
- **决策记录**:与 MASTER.md 的冲突及裁决(按 SKILL.md 裁决表:a11y/触控/平台规则 pro-max 赢;美学自由轴 frontend-design 赢;craft-floor ban 红线)
|
||||
|
||||
**验收**:design-plan.md 四要素齐全 + 自检一节存在 + 记账在案。
|
||||
**验收**:MASTER.md 存在且与方向一致,或降级路径已记录;校验检索在账本;design-plan 决策记录含 S3 的改值/降级条目。
|
||||
|
||||
## 停点 1
|
||||
|
||||
把 BRIEF(要点)、MASTER(风格/色/字/反模式摘要)、design-plan(ASCII + 色板 + 原则 + 决策记录)展示给用户,明确请求确认或调整意见,**终止回合**。用户豁免(已说「一口气跑完」)→ 跳过继续。
|
||||
把 BRIEF(要点)、design-plan(方向 + ASCII + 色板 + 原则)、MASTER 要点或 S3 降级说明展示给用户,明确请求确认或调整意见,**终止回合**。用户豁免(已说「一口气跑完」)→ 跳过继续。
|
||||
|
||||
## S4 高保真构建
|
||||
|
||||
@@ -74,7 +74,7 @@ python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-stac
|
||||
1. Read `<DEP_IMP>/reference/craft-floor.md` 并记账:
|
||||
`python3 <SKILL>/scripts/log_call.py impeccable --run-dir <RUN> --note S4-craft-floor --load <DEP_IMP>/reference/craft-floor.md`
|
||||
2. 构建:默认无构建链的 HTML/CSS/JS(单文件优先,可拆 CSS/JS 文件)。硬性要求:
|
||||
- token 全部来自 MASTER.md(色/字/间距/圆角/阴影),不发明 system token 之外的美学量
|
||||
- token 来自 MASTER.md(或降级时的 design-plan token 表),不发明规范之外的美学量
|
||||
- 布局与个性按 design-plan;SVG 图标(真图标库或手绘一致笔画),禁 emoji 图标
|
||||
- craft-floor 全条目施工时遵守(尤其:eyebrow 是 ban;嵌套卡片必错;elevation 声明一次;浏览器表面——selection/caret/scrollbar/focus ring/表格数字——要从色板定制)
|
||||
- 交互真实可用(点击/切换/滚动行为写 JS),不是静态画片
|
||||
@@ -114,7 +114,7 @@ python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-stac
|
||||
|
||||
## 停点 2
|
||||
|
||||
展示审查报告,给结构化选项请用户定修复范围:全部 / Top 3 / 仅 P0–P1 / 保持现状。**终止回合**;豁免规则同停点 1(豁免时默认修 P0+P1)。
|
||||
展示审查报告,给结构化选项请用户定修复范围:全部 / Top 3 / 仅 P0–P1 / 保持现状。**终止回合**;豁免规则同停点 1(豁免时默认修 P0+P1,并在审查报告末尾补字面行 `Questions skipped: 停点2经用户豁免(默认修复 P0+P1)`,满足 impeccable critique 的收尾契约)。
|
||||
|
||||
## S6 优化迭代
|
||||
|
||||
|
||||
Reference in New Issue
Block a user