@lark-apaas/coding-steering 0.1.18-dev.a23a6bb → 0.1.18-dev.e2d9278

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.18-dev.a23a6bb",
+  "version": "0.1.18-dev.e2d9278",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [

package/steering/design-html/skills/make-a-deck/SKILL.md

@@ -61,7 +61,7 @@ scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据
 
 装不下时按这个顺序处理：**先删解释和重复内容，再换成更省空间的表达，最后拆页或加页。** 不要靠缩字号、压行距、缩 padding 或 `overflow: hidden` 把问题藏起来。
 
-章节页、引用页和大数字页本来就可以很疏，不需要为了填满画面硬加内容。
+下限也要看：普通内容页折算的内容底边不到画布六成（约 650px），是内容撑不起一页的信号——和邻页合并，或按「页面不能太空」的顺序增密，别让它硬占一页。章节页、引用页和大数字页本来就可以很疏，不需要为了填满画面硬加内容。
 
 ## 第二步：生成幻灯片框架
 
@@ -158,6 +158,7 @@ scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据
 - 禁止“圆角卡片 + 单边彩色 border”，包括 `border-left`、`border-top` 和 `border-bottom`。颜色真有含义时，用编号、整块色底或整页色调表达。
 - 引用可以用一根直角竖线，但不要再套圆角卡片。
 - 编号、标签、分隔线只有在真的表示序号、分类或状态时才加。
+- **时间线、流程带这类结构必须有真实高度。** 用绝对定位或上下交替布局做时间线时，容器必须显式设 height（或确保由在流内容撑开）——只有 padding 没有高度的容器会塌成一条细带，整页剩下大片空白。写完这类结构立刻回读两件事：容器有没有高度；CSS 里定义的交替类（如 `.top` / `.below`）是不是真的挂在了 HTML 元素上——类定义了没挂等于没写。
 
 ### 文案说人话
 
@@ -172,10 +173,20 @@ scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据
 具体做法
 
 1. 用 grep 找到每个 `<section` 的行号，read_file 逐页回读代码。页数多可以分批读，但一页都不能跳过。
-2. 每页核对两个方向，并和 scratchpad.txt 里「装多少」的判定对账：
+2. 每页核对两个方向，并和 scratchpad.txt 里「装多少」的判定对账。两个方向要分开估：算装不下时余量往大留，算装不满时按紧凑值算——用同一套偏大的数字两头套，空页会被估厚而漏判。
    - **装不下**：按第一步的公式粗算高度，接近或超过 820px 就是溢出风险。
-   - **装不满**：内容估算高度只有安全区一半上下、内容集中在上半页或一角、出现拉高的空卡片或大块无功能空白，都算欠填充，同样不通过。章节页、引用页、大数字页的刻意留白除外，但要说得出这页的留白在突出什么。
-3. 在回复里输出核对表，每页一行：页名 / 内容组成（几行正文、几行表格、几张卡片） / 高度估算 / 判定（通过、装不下或装不满）。不通过的页先回去改——装不下按「先删、再换表达、最后拆页」处理；装不满先调布局适配、其次才补内容（按「页面不能太空」的顺序）——改完把这页重新核对一遍。
+   - **装不满**：普通内容页的内容底边至少要到画布六成（约 650px）。低于这条线、内容集中在上半页或一角、出现拉高的空卡片或大块无功能空白，都算装不满——**820px 是天花板不是及格线，「没超」不等于「通过」**。估出来偏低的页先怀疑容器塌陷（只有 padding 没 height、类定义了没挂），回读代码确认后再下判定。章节页、引用页、大数字页的刻意留白可以放行，但判定里必须写成「刻意留白：突出 XX」——写不出在突出什么，就不是刻意，是没做完。
+3. 在回复里输出核对表。用固定格式：以「质检核对表」开头，每页一行、竖线分隔，行数必须等于 `<section>` 数——这个格式是给平台机器校验覆盖率用的，不要自由发挥：
+
+   ```
+   质检核对表
+   01 | 封面 | 大字标题+副标题 | 底边520px | 刻意留白：突出满版主视觉
+   02 | 市场规模 | 6行正文+1图表 | 底边780px | 通过
+   03 | 发展历程 | 时间线5节点 | 底边940px | 装不下
+   04 | 团队介绍 | 3张头像卡 | 底边430px | 装不满
+   ```
+
+   五列依次是：页码 | data-label | 内容组成（几行正文、几行表格、几张卡片） | 内容底边（内容实际到达的最低位置，不是「用了多少预算」） | 判定。判定按数字来：底边接近或超过 820px 是装不下；普通内容页底边低于 650px 是装不满；刻意留白的页写「刻意留白：突出 XX」。不通过的页先回去改——装不下按「先删、再换表达、最后拆页」处理；装不满先调布局适配、其次才补内容（按「页面不能太空」的顺序）——改完把这页重新核对一遍。
 
 两条纪律：
 
@@ -184,11 +195,12 @@ scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据
 
 核对之后，逐项过一遍下面的清单：
 
-- 高度粗算没有超过 820px，各类高密度结构没有超过前面的上限。
+- 每页都写了内容底边：没有超过 820px 的页；普通内容页也没有低于 650px 的——低于的要么已增密或合并，要么标了刻意留白的理由。各类高密度结构没有超过前面的上限。
 - 每页只讲一件事，没有把两个高密度结构塞在一起。
 - 关键文字不小于 24px，没有靠缩字、压间距或 `overflow: hidden` 掩盖溢出。
 - 页码、总页数和 `<section>` 数量一致。
 - 没有内容被画幅裁掉，也没有元素互相遮挡。
+- 时间线、流程带等绝对定位或交替布局的容器有真实高度，交替类名真的挂上了，没有塌成细带。
 - 没有无意义的描边圆角卡片、单边彩色圆角卡片、阴影、发光、玻璃拟态和装饰性渐变。
 - 封面有一个主视觉，不是“小图标 + 居中标题 + 居中副标题”的固定三件套。
 - 页码和眉标统一；相邻页面的骨架有变化，但变化跟内容有关。