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

package/package.json

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

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

@@ -30,6 +30,8 @@ metadata:
 3. **用什么形式。** 例如大数字、图表、表格、时间线、引用、图文并排或多栏对比。形式要跟内容的关系走，不要每页都铺成卡片。
 4. **装多少。** 写清条目数、表格行数、卡片数，并判断“放得下”还是“要拆页”。
 
+scratchpad.txt 不是写完就丢的手续，它是后续所有步骤的依据：写每一页 HTML 时，都按它写的「形式」和「装多少」来落；写的过程中发现计划不合适，先回来更新对应条目，再改页面——文件和页面要始终一致。修改已有 deck 时，先 read_file scratchpad.txt 恢复口径和每页预算；改动涉及内容增删的页，同步更新它的条目。
+
 ### 基于用户输入设计演讲内容
 
 不要把来源里的长段落原样塞进卡片。先把它改成适合台上讲的内容：数字、关键词、短标签、步骤、对比项或者一句话结论。
@@ -128,7 +130,7 @@ metadata:
 
 避免溢出的同时，也要保证普通内容页有足够的信息密度。内容只缩在页面一小块、其余地方大面积空着，通常说明内容或版式还没组织好。
 
-页面太空时，按这个顺序处理：**先放大真正的主视觉，再把短文字改成图文、对比、流程或数据展示，然后补充与本页结论直接相关的信息；内容仍撑不起一页，就和相邻页面合并。**
+页面太空时，先调布局、后补内容：**首先调整布局让现有内容撑起构图——放大真正的主视觉，升格为大字观点页或引用页式的构图，或把短文字改成图文、对比、流程或数据展示；布局实在调不出来，再补充与本页结论直接相关的信息；仍撑不起一页，就和相邻页面合并。**不要一上来就编内容填空。
 
 不要靠拉高空卡片、统一放大所有字号、添加无意义图标或堆装饰来填空。章节页、引用页、大数字页和满版图片页可以主动留白，但留白必须在突出重点或帮助构图。
 
@@ -165,20 +167,22 @@ metadata:
 
 ## 自检：run_commit 的前置条件
 
-写完 HTML 不等于做完。调用 run_commit 之前，必须先做一次代码回读核对，并把结果写出来——核对表没有出现，就还没到提交这一步。
+写完 HTML 不等于做完。调用 run_commit 之前，必须对**每一页**做一次代码回读质检，并把结果写出来——核对表没有出现，或者没有覆盖全部页面，就还没到提交这一步。
 
 具体做法
 
-1. 用 grep 找到每个 `<section` 的行号，挑出内容最满的两三页，加上所有含表格、时间线或卡片阵的页。
-2. read_file 回读这些页的代码，按第一步的公式逐页粗算高度。
-3. 在回复里输出核对表，每页一行：页名 / 内容组成（几行正文、几行表格、几张卡片） / 判定（通过或拆页）。有页超过 820px，先回去改，改完把这页重新核对一遍。
+1. 用 grep 找到每个 `<section` 的行号，read_file 逐页回读代码。页数多可以分批读，但一页都不能跳过。
+2. 每页核对两个方向，并和 scratchpad.txt 里「装多少」的判定对账：
+   - **装不下**：按第一步的公式粗算高度，接近或超过 820px 就是溢出风险。
+   - **装不满**：内容估算高度只有安全区一半上下、内容集中在上半页或一角、出现拉高的空卡片或大块无功能空白，都算欠填充，同样不通过。章节页、引用页、大数字页的刻意留白除外，但要说得出这页的留白在突出什么。
+3. 在回复里输出核对表，每页一行：页名 / 内容组成（几行正文、几行表格、几张卡片） / 高度估算 / 判定（通过、装不下或装不满）。不通过的页先回去改——装不下按「先删、再换表达、最后拆页」处理；装不满先调布局适配、其次才补内容（按「页面不能太空」的顺序）——改完把这页重新核对一遍。
 
 两条纪律：
 
-- 建 todo 时，「回读核对页面高度」要单独一条，它的完成标准就是核对表已出现在回复里。没有对应的 read_file 调用和核对表就把它标成 completed，等于没做自检。
+- 建 todo 时，「逐页质检」要单独一条，它的完成标准就是覆盖全部页面的核对表已出现在回复里。没有对应的 read_file 调用和核对表就把它标成 completed，等于没做质检。
 - 截图是可选补充，不能替代代码回读；只截封面一张不算检查。
 
-核对高度之后，逐项过一遍下面的清单；重点仍是最满的两三页和所有表格、时间线、卡片阵：
+核对之后，逐项过一遍下面的清单：
 
 - 高度粗算没有超过 820px，各类高密度结构没有超过前面的上限。
 - 每页只讲一件事，没有把两个高密度结构塞在一起。