diff --git a/product-planning/references/stage-delivery/SKILL.md b/product-planning/references/stage-delivery/SKILL.md index c691d5b..158fbb9 100644 --- a/product-planning/references/stage-delivery/SKILL.md +++ b/product-planning/references/stage-delivery/SKILL.md @@ -43,6 +43,9 @@ description: 产品规划第③段，界面交互。设计工程供给来自 ope 3、`design-templates/web-prototype/`：种子 `assets/template.html` ＋ 8 个版式骨架 ＋ 自查清单。 +> 🔴 **那 8 个骨架 ⛔ 不许用在工具型页面上（2026-10-08 补）**：它们是营销页向，工具型照套会长出「标题上下各一行小字」的三段式（名单与「为什么工具型不能套」只许在 `references/layouts-tooling.md` 开头写一次，⛔ 本块不复述）。 +> 工具型页面版式走本项目自己的 `references/layouts-tooling.md` —— 它的 §0 是**九档**骨架名单（2026-10-08 追加「导航型（外壳）」一档，形态细则 = §4.9 导航栏）。 + ⭐ 选了自带的 `design-system-tiaoyue` 时怎么读（⚠️ 套内命名与 `open-design` 不同形，别按 `DESIGN.md` 去找）： | 要什么 | 套内路径 | @@ -52,11 +55,15 @@ description: 产品规划第③段，界面交互。设计工程供给来自 ope | 组件形态 | 同目录 `references/components.md` ＋ `references/design-system.html`（组件族清单 `references/library.json`） | | 已知冲突 / 取舍记录 | 同目录 `references/known-conflicts.md` ＋ `references/capture-notes.md` | +> ⚠️ **自带样式库的能力边界（2026-10-08 实测补充）**：实测只到**调色板级** —— 语义色 / 圆角 / 字体栈 / 按钮与输入框令牌；**几何与版式不在包内**（栏宽、项高、内衬、间距、组件尺寸一律没有），`references/design-system.html` 里也**不含源站的界面骨架**。 +> ⛔ 不许把「供给在位」读成「已经有设计系统了」；要几何就**回源站实测**或另找来源，拿不到就在 `3d-审查报告.md` 里明说「无来源」。 + > ⚠️ 路径怎么找：自带件一律按**段内相对路径**引用（`assets/open-design/...`、`assets/design-systems/...`），⛔ 不按绝对路径爬、⛔ 不写死 `../` 层数；`oil-ui-pro` 按技能名引用（宿主按名加载，与物理位置无关）。 > 🔴 定调来源唯一：每次设计只选一套，默认与可选**不混用**（混用 = 没有调性）。套名与选择理由写进 `DESIGN.md`。 > ⛔ 判据正文仍只在本段（`references/execution-runbook.md` 与 `references/layouts-tooling.md`）。⚠️ 供给是分层的，分层定义见 §供给：`oil-ui-pro` 是**基础层**，本段自有判据是**叠加层**；同一条判据两处都有且口径不同时，⛔ 本段不许放宽基础层，只许更严、更具体，并在 runbook §3.4 标注「本项目追加」。 > ⛔ 不许把 `oil-ui-pro` 的评分循环当成 D 阶段的替代：它是评审方法，Gate-1/2/3 该过还得过。 > ⛔ 不动用可选来源时，⛔ 不许凭感觉编一套顶上（那正是本项目反复踩的坑）；craft 独有的那几项（反 AI 味 / 无障碍 / 表单校验 / 动效纪律）明说「本次无供给来源」。 +> ⚠️ **但"提一句"不算完（2026-10-08 补）**：这四项必须逐项**落进** `3d-审查报告.md`，写成**本段证据缺口**（格式：「无供给来源，本项未判」），⛔ 不许默不作声地跳过、也⛔ 不许拿别的判据冒充它过了 —— 判据没有来源 ≠ 这一项可以不做结论。 > ⚠️ `oil-ui-pro` 自带联网版本检查与自动更新（每次使用会连 `ui.oiloil.org`，发现新版用 `npx` 覆盖自身目录）。这是本项目收录时用户明确要求全量搬入的例外项，与「依赖外部服务一律不收」的既有纪律冲突，记录在案，不扩散到其他技能。想关掉设环境变量 `OIL_NO_UPDATE_CHECK=1`。 > 供给件都不依赖付费云 / MCP / API Key 才能用于设计：`open-design` 去掉那些之后剩下的全是静态 md / css / html（其 daemon、云模型服务、`packages/components` 的 tsx 未收录）；`oil-ui-pro` 的设计方法宿主中立、离线可用（联网仅用于版本检查）。 > 冲突处以 §供给·方法主线（基础层）为准；本段自有判据与 `DESIGN.md` 是叠加层，只许更严，⛔ 不许与基础层相反。供给件的价值在给正向目标、给方法。 diff --git a/product-planning/references/stage-delivery/references/layouts-tooling.md b/product-planning/references/stage-delivery/references/layouts-tooling.md index 82b95d1..44f2668 100644 --- a/product-planning/references/stage-delivery/references/layouts-tooling.md +++ b/product-planning/references/stage-delivery/references/layouts-tooling.md @@ -391,9 +391,14 @@ > ⛔ 这不能一律判红 —— 得逐条回答上表两问。放行的事实条必须同时满足：① 是数据不是句子；② 与该对象的主操作按钮同属一个视觉单元（同行或紧邻），而不是独占了标题的第二行。 > ✅ 若事实条独占标题下方一整行（如本原型首版），仍判不过 ⇒ 把它挪到与主操作同行。 -### 5.5.2 导航栏不许只有图标（治法：「默认带标签，折叠才收」） +### 5.5.2 导航栏的判据是「名字常驻可读」，不是「栏有多宽」（2026-10-08 订正） -实证：「sidebar becomes **a wall** and needs grouping or a different model」（>15 项时）；「**Collapsible Sidebars** …… shrinks to just 64px, **hiding the text labels and showing only the icons**」—— 只图标是折叠态，不是默认态。 +> 🔴 **订正原因（本项目实测事故，2026-10-08）**：原文写「主导航默认必须带文字标签（宽 ~240–280px），⛔ 不许一上手就是 52px 纯图标栏」—— +> 它把**手段（栏宽 240–280px）当成了目的（名字常驻可读）**。于是出现了一个「判据判不过、但产品上完全成立」的形态： +> **64px 药丸图标栏 ＋ 图标 24 ＋ 2 字短名常驻**（源站 `www.tiaoyue.com` 的 `app-sidebar` 就是这个，实测栏 64 ／ 项 56×78 ／ 名字 12px 常驻）。 +> 更坏的是它引发了**反向事故**：为了"合规"，执行者把标签设成 `display:none`（宽屏只留图标 ＋ 悬停提示）—— +> 表面上写成"64px 图标栏"，实际比原文的反例更狠（连折叠态的展开入口都没有）。**判据的漏洞被拿去当成了通行证。** +> ⚠️ 同型警戒：凡"拿某个数值当判据"的条目，先问一句**那个数值是目的还是手段**；是手段就把它写成可判的实质。 实证（原文引用保留）：「sidebar becomes **a wall** and needs grouping or a different model」（>15 项时）；「**Collapsible Sidebars** …… shrinks to just 64px, **hiding the text labels and showing only the icons**」—— 只图标是折叠态，不是默认态。