le-app-design v1.2.0：确认环节与一致性修复（冷读评审驱动）。①盲盒阀门：S4 拆 a/b，新增停点 1.5 首屏确认（截图必发，豁免停顿不豁免发图），停点 2 附修复前后截图；②修复三处自相矛盾：轻量路由 vs 验收门硬冲突（evidence_report 新增 --require 支持子集门与履职前缀，四象限回归通过）、S3 降级 vs S7 必验 MASTER（改条件 artifact）、截图档位两口径（统一 390 主档+375 兼容，移动 Web 免桌面）；③补占位符定义：项目代号进 BRIEF、slug 来源、S5 双 sub-agent 派发模板要点、note 命名规范表、回弹降级三条操作化判据、轻量路由 S2快速版/S4′/S5′ 定义、保持现状=跳 S6 直 S7
This commit is contained in:
leroy
@@ -6,7 +6,7 @@ description: |
|
||||
不要触发：点名单个上游 Skill 的直接请求（直连该上游即可）；写作与排版类任务；单张配图生成；纯功能开发与排障（无设计诉求）。
|
||||
metadata:
|
||||
author: Leroy
|
||||
version: 1.1.0
|
||||
version: 1.2.0
|
||||
runtimes: zcode, claude-code, codex, opencode
|
||||
requires:
|
||||
- "ui-ux-pro-max (MIT, nextlevelbuilder/ui-ux-pro-max-skill)"
|
||||
@@ -23,7 +23,7 @@ metadata:
|
||||
1. **真调用，不冒充。** 三个上游必须以其原生形态被实际调用：ui-ux-pro-max 跑它的 `search.py` CLI；impeccable 跑它的 `impeccable` CLI 并按其 SKILL.md 路由装载 reference/*.md playbook 照做；frontend-design 经宿主 Skill 工具装载（或 Read 原文全文）。禁止只引用名字、模仿理念、用自写流程替代。
|
||||
2. **依赖门不过，不许动工。** S0 检测到任何一个上游缺失/失活，立即向用户报告缺什么、怎么装，终止本次运行。不许跳过、不许假装集成完成。
|
||||
3. **调用必记账。** 每次对上游的调用（含 playbook/文档装载）都经 `log_call.py` 落入本次运行目录的 `calls.jsonl`。没进账本的调用视为没发生。
|
||||
4. **交付必过验收门。** S7 跑 `evidence_report.py`，三方各有 ≥1 条成功调用记录才可宣称完成；否则如实报告 FAIL 与原因。
|
||||
4. **交付必过验收门。** S7 跑 `evidence_report.py`，门按任务类型的 `--require` 集合判：完整流程要求三方各 ≥1 条**履职阶段**成功调用（pro-max 计 S3- 前缀，防 S2 调研混门）；轻量路由只要求参与该路由的上游。不过门不许宣称完成。
|
||||
5. **不改上游。** 三个上游目录只读（调用、装载），任何修改都不属于本 Skill 的职责。
|
||||
6. **用户 brief 原话 > 一切。** 三个上游都自认 brief 优先，本 Skill 同样：brief 钉死的方向照办，冲突记入决策日志。
|
||||
|
||||
@@ -50,7 +50,7 @@ python3 <SKILL>/scripts/check_deps.py --out <RUN>/deps.json
|
||||
|
||||
### S1 产品理解
|
||||
|
||||
产出 `<RUN>/BRIEF.md`：产品是什么、给谁、核心任务、平台与形态（移动 Web / 桌面 / 响应式）、impeccable 四模式归属（Persuade / Operate / Read / Experience）。brief 信息不足且影响方向 → 问用户；足够 → 写明假设直接做。
|
||||
产出 `<RUN>/BRIEF.md`：**项目代号**（供 S3 的 `-p` 与目录命名）、产品是什么、给谁、核心任务、平台与形态、impeccable 四模式归属（Persuade / Operate / Read / Experience）。brief 信息不足且影响方向 → 问用户；足够 → 写明假设直接做。
|
||||
|
||||
### S2 视觉探索 — frontend-design（方向先行）
|
||||
|
||||
@@ -78,11 +78,12 @@ python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S3-desi
|
||||
|
||||
向用户展示 BRIEF + design-plan（设计方向）+ MASTER 要点或降级说明，等确认或调整后再进构建。用户已明确说「一口气跑完」→ 豁免本停点，继续。**本停点必须终止回合等待用户，不得自答自继续。**
|
||||
|
||||
### S4 高保真构建
|
||||
### S4 高保真构建（a 首屏 → 停点 1.5 → b 全量）
|
||||
|
||||
1. Read `<DEP_IMPECCABLE>/reference/craft-floor.md`（impeccable 施工底线，装载即调用）并记账 `log_call.py impeccable --load <该文件>`。
|
||||
2. 照规范 tokens（MASTER.md，或 S3 降级时的 design-plan token 表）+ design-plan 写可运行、可交互的 Web 原型（默认单文件或多文件 HTML/CSS/JS，无构建链）。
|
||||
3. headless Chrome 截图核对（375/390 移动档 + 桌面档），按 craft-floor「一次看一批」原则修完再截。
|
||||
1. Read `<DEP_IMPECCABLE>/reference/craft-floor.md`（装载即调用）并记账。
|
||||
2. **S4a 首屏**：先只构建主界面一屏（真实内容 + 规范 token + design-plan 个性），390×844 截图。
|
||||
3. **停点 1.5（首屏确认，回合终止点）**：把首屏截图发到对话，请用户确认「方向落地长这样」再继续——这一站消除盲盒：成品第一次见面不再是 S5 之后。豁免时跳过停顿，**但截图仍必须发出**。
|
||||
4. **S4b 全量**：其余屏 + 完整交互（390 主档 + 375 兼容档截图；移动 Web 任务免桌面档）。显隐/布局断言用渲染事实（computed display / boundingRect），不信 hidden 属性。
|
||||
|
||||
### S5 设计审查 — impeccable
|
||||
|
||||
@@ -93,7 +94,7 @@ python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S3-desi
|
||||
|
||||
### 停点 2（回合终止点）
|
||||
|
||||
展示审查报告，与用户确认修复范围（全部 / Top 3 / 仅 P0-P1）再进 S6。「一口气跑完」豁免同上；**豁免时默认修复范围为 P0+P1，且审查报告末尾必须补字面行 `Questions skipped: 停点2经用户豁免（默认修复 P0+P1）`——这是 impeccable critique 契约的收尾要求，漏了即该次 critique 不完整。**
|
||||
展示审查报告**并附修复前后关键截图**（不是纯文字报告——用户确认修复范围时应已见过成品），四选一：全部 / Top 3 / 仅 P0-P1 / 保持现状（现状=跳过 S6 直接 S7，报告照出）。「一口气跑完」豁免同上；豁免时默认修 P0+P1，且审查报告末尾必须补字面行 `Questions skipped: 停点2经用户豁免（默认修复 P0+P1）`——这是 impeccable critique 契约的收尾要求，漏了即该次 critique 不完整。
|
||||
|
||||
### S6 优化迭代
|
||||
|
||||
@@ -102,17 +103,20 @@ python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S3-desi
|
||||
### S7 交付 + 验收门
|
||||
|
||||
```bash
|
||||
# 完整流程（默认三方门，pro-max 计履职前缀）
|
||||
python3 <SKILL>/scripts/evidence_report.py --run-dir <RUN> --out <RUN>/INTEGRATION-REPORT.md \
|
||||
--artifact <原型主文件> --artifact <截图...>
|
||||
--require "ui-ux-pro-max:S3-,frontend-design:S2-,impeccable" \
|
||||
--artifact <原型主文件> --artifact <RUN>/shot-*.png --artifact <RUN>/design-plan.md
|
||||
# 系统路径（非降级）另加 --artifact design-system/<slug>/MASTER.md（slug 跑完 S3 后 ls design-system/ 确认）
|
||||
```
|
||||
|
||||
交付物 = 原型（可打开可交互）+ BRIEF/design-plan/MASTER + 审查报告与快照 + INTEGRATION-REPORT（三方调用统计、命令清单、产物存在性核验）。报告 FAIL（任何一方 0 成功调用）→ 不许宣称完成，如实说明缺什么。
|
||||
交付物 = 原型（可打开可交互）+ BRIEF/design-plan/MASTER（或降级说明）+ 审查报告与快照 + INTEGRATION-REPORT。报告 FAIL（门或产物缺失）→ 不许宣称完成，如实说明缺什么。
|
||||
|
||||
## 轻量任务路由
|
||||
## 轻量任务路由（含各自的验收门口径）
|
||||
|
||||
- **仅审查/体检**（「帮我审一下这个原型的设计」）：S0 → S5（→停点2）→ S6 → S7。
|
||||
- **局部修改**（「把这个页面间距调好」）：S0 → 若涉及视觉决策走 S2 快速版 → S4′（craft-floor 装载后施工）→ S5′（detect+复截）→ S7。
|
||||
- 三上游经 check_deps 解析后始终可调用；轻量路由是省阶段，不是换实现。
|
||||
- **仅审查/体检**（「帮我审一下这个原型的设计」）：S0 → S5（完整 critique：装载 critique.md + 双 sub-agent + detect + 快照）→ 停点 2 →（S6 按所选范围）→ S7。验收门 `--require "impeccable"`。
|
||||
- **局部修改**（「把这个页面间距调好」）：S0 → S2 快速版（涉及视觉决策时：装载 frontend-design + 记账，方向口头确认即可，无 design-plan 全文档）→ S4′（craft-floor 装载 + 就地修改 + 渲染事实断言 + 复截图）→ S5′（detect --json + 复截对比，不走完整 critique）→ S7。验收门 `--require "impeccable"`（走了 S2 快速版则加 `,frontend-design`）。
|
||||
- 三上游经 check_deps 解析后始终可调用；轻量路由是省阶段，不是换实现——省掉的阶段不要求调用，但**不许伪造调用记录凑门**。
|
||||
|
||||
## 失败模式与停手点
|
||||
|
||||
|
||||
Reference in New Issue
Block a user