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

package/package.json

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

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

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