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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.18-dev.ac6c20c",
+  "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

@@ -17,19 +17,21 @@ metadata:
 
 先看用户给的主题、受众、场合、品牌和附件。能从这些信息判断风格，就直接判断；确实判断不了时，用提问工具主动问清楚。
 
-先想清楚：这是谁在什么场合讲、观众需要记住什么、哪些页是重点。用一两句话写进 `scratchpad.md`，后面所有页面都按这个口径做。
+先想清楚：这是谁在什么场合讲、观众需要记住什么、哪些页是重点。用一两句话写进 `scratchpad.txt`，后面所有页面都按这个口径做。
 
 视觉方向先调用 frontend-design skill 搭框架，再从主题、受众和场景里提炼几个视觉关键词，用来决定配色、字体、图片类型和页面节奏。它和本 skill 冲突时，以本 skill 为准。
 
 ## 第一步：规划幻灯片大纲
 
-必须先写 `scratchpad.md`。每页至少写清四件事：
+必须先写 `scratchpad.txt`。这是本 skill 明确要求创建的工作文件，属于显式创建，不受「不主动创建文档文件」限制的约束。每页至少写清四件事：
 
 1. **标题。** 全篇统一用主题式标题，或者统一用直接给结论的标题。只看标题，也应该能跟上整个故事。
 2. **这页讲什么。** 一页只处理一个问题、一组关系或一个动作。如果这句话里出现“以及、同时、另外、并且”，通常就该拆页。
 3. **用什么形式。** 例如大数字、图表、表格、时间线、引用、图文并排或多栏对比。形式要跟内容的关系走，不要每页都铺成卡片。
 4. **装多少。** 写清条目数、表格行数、卡片数，并判断“放得下”还是“要拆页”。
 
+scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据：写每一页 HTML 时，都按它写的「形式」和「装多少」来落；写的过程中发现计划不合适，先回来更新对应条目，再改页面——文件和页面要始终一致。修改已有 deck 时，先 read_file scratchpad.txt 恢复口径和每页预算；改动涉及内容增删的页，同步更新它的条目。
+
 ### 基于用户输入设计演讲内容
 
 不要把来源里的长段落原样塞进卡片。先把它改成适合台上讲的内容：数字、关键词、短标签、步骤、对比项或者一句话结论。
@@ -59,7 +61,7 @@ metadata:
 
 装不下时按这个顺序处理：**先删解释和重复内容，再换成更省空间的表达，最后拆页或加页。** 不要靠缩字号、压行距、缩 padding 或 `overflow: hidden` 把问题藏起来。
 
-章节页、引用页和大数字页本来就可以很疏，不需要为了填满画面硬加内容。
+下限也要看：普通内容页折算的内容底边不到画布六成（约 650px），是内容撑不起一页的信号——和邻页合并，或按「页面不能太空」的顺序增密，别让它硬占一页。章节页、引用页和大数字页本来就可以很疏，不需要为了填满画面硬加内容。
 
 ## 第二步：生成幻灯片框架
 
@@ -128,7 +130,7 @@ metadata:
 
 避免溢出的同时，也要保证普通内容页有足够的信息密度。内容只缩在页面一小块、其余地方大面积空着，通常说明内容或版式还没组织好。
 
-页面太空时，按这个顺序处理：**先放大真正的主视觉，再把短文字改成图文、对比、流程或数据展示，然后补充与本页结论直接相关的信息；内容仍撑不起一页，就和相邻页面合并。**
+页面太空时，先调布局、后补内容：**首先调整布局让现有内容撑起构图——放大真正的主视觉，升格为大字观点页或引用页式的构图，或把短文字改成图文、对比、流程或数据展示；布局实在调不出来，再补充与本页结论直接相关的信息；仍撑不起一页，就和相邻页面合并。**不要一上来就编内容填空。
 
 不要靠拉高空卡片、统一放大所有字号、添加无意义图标或堆装饰来填空。章节页、引用页、大数字页和满版图片页可以主动留白，但留白必须在突出重点或帮助构图。
 
@@ -156,6 +158,7 @@ metadata:
 - 禁止“圆角卡片 + 单边彩色 border”，包括 `border-left`、`border-top` 和 `border-bottom`。颜色真有含义时，用编号、整块色底或整页色调表达。
 - 引用可以用一根直角竖线，但不要再套圆角卡片。
 - 编号、标签、分隔线只有在真的表示序号、分类或状态时才加。
+- **时间线、流程带这类结构必须有真实高度。** 用绝对定位或上下交替布局做时间线时，容器必须显式设 height（或确保由在流内容撑开）——只有 padding 没有高度的容器会塌成一条细带，整页剩下大片空白。写完这类结构立刻回读两件事：容器有没有高度；CSS 里定义的交替类（如 `.top` / `.below`）是不是真的挂在了 HTML 元素上——类定义了没挂等于没写。
 
 ### 文案说人话
 
@@ -163,15 +166,41 @@ metadata:
 
 每页单独拿出来，也应该能看懂大意。
 
-## 自检
+## 自检：run_commit 的前置条件
+
+写完 HTML 不等于做完。调用 run_commit 之前，必须对**每一页**做一次代码回读质检，并把结果写出来——核对表没有出现，或者没有覆盖全部页面，就还没到提交这一步。
+
+具体做法
+
+1. 用 grep 找到每个 `<section` 的行号，read_file 逐页回读代码。页数多可以分批读，但一页都不能跳过。
+2. 每页核对两个方向，并和 scratchpad.txt 里「装多少」的判定对账。两个方向要分开估：算装不下时余量往大留，算装不满时按紧凑值算——用同一套偏大的数字两头套，空页会被估厚而漏判。
+   - **装不下**：按第一步的公式粗算高度，接近或超过 820px 就是溢出风险。
+   - **装不满**：普通内容页的内容底边至少要到画布六成（约 650px）。低于这条线、内容集中在上半页或一角、出现拉高的空卡片或大块无功能空白，都算装不满——**820px 是天花板不是及格线，「没超」不等于「通过」**。估出来偏低的页先怀疑容器塌陷（只有 padding 没 height、类定义了没挂），回读代码确认后再下判定。章节页、引用页、大数字页的刻意留白可以放行，但判定里必须写成「刻意留白：突出 XX」——写不出在突出什么，就不是刻意，是没做完。
+3. 在回复里输出核对表。用固定格式：以「质检核对表」开头，每页一行、竖线分隔，行数必须等于 `<section>` 数——这个格式是给平台机器校验覆盖率用的，不要自由发挥：
+
+   ```
+   质检核对表
+   01 | 封面 | 大字标题+副标题 | 底边520px | 刻意留白：突出满版主视觉
+   02 | 市场规模 | 6行正文+1图表 | 底边780px | 通过
+   03 | 发展历程 | 时间线5节点 | 底边940px | 装不下
+   04 | 团队介绍 | 3张头像卡 | 底边430px | 装不满
+   ```
+
+   五列依次是：页码 | data-label | 内容组成（几行正文、几行表格、几张卡片） | 内容底边（内容实际到达的最低位置，不是「用了多少预算」） | 判定。判定按数字来：底边接近或超过 820px 是装不下；普通内容页底边低于 650px 是装不满；刻意留白的页写「刻意留白：突出 XX」。不通过的页先回去改——装不下按「先删、再换表达、最后拆页」处理；装不满先调布局适配、其次才补内容（按「页面不能太空」的顺序）——改完把这页重新核对一遍。
+
+两条纪律：
+
+- 建 todo 时，「逐页质检」要单独一条，它的完成标准就是覆盖全部页面的核对表已出现在回复里。没有对应的 read_file 调用和核对表就把它标成 completed，等于没做质检。
+- 截图是可选补充，不能替代代码回读；只截封面一张不算检查。
 
-不要求每页截图。可以给内容最丰富的页面截图，或者直接回读 HTML；重点检查最满的两三页，以及所有表格、时间线和卡片阵：
+核对之后，逐项过一遍下面的清单：
 
-- 高度粗算没有超过 820px，各类高密度结构没有超过前面的上限。
+- 每页都写了内容底边：没有超过 820px 的页；普通内容页也没有低于 650px 的——低于的要么已增密或合并，要么标了刻意留白的理由。各类高密度结构没有超过前面的上限。
 - 每页只讲一件事，没有把两个高密度结构塞在一起。
 - 关键文字不小于 24px，没有靠缩字、压间距或 `overflow: hidden` 掩盖溢出。
 - 页码、总页数和 `<section>` 数量一致。
 - 没有内容被画幅裁掉，也没有元素互相遮挡。
+- 时间线、流程带等绝对定位或交替布局的容器有真实高度，交替类名真的挂上了，没有塌成细带。
 - 没有无意义的描边圆角卡片、单边彩色圆角卡片、阴影、发光、玻璃拟态和装饰性渐变。
 - 封面有一个主视觉，不是“小图标 + 居中标题 + 居中副标题”的固定三件套。
 - 页码和眉标统一；相邻页面的骨架有变化，但变化跟内容有关。