@lark-apaas/coding-steering 0.1.16 → 0.1.17-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/steering/design-html/skills/make-a-deck/SKILL.md +6 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lark-apaas/coding-steering",
3
- "version": "0.1.16",
3
+ "version": "0.1.17-alpha.0",
4
4
  "description": "Stack-specific steering content for miaoda-coding templates",
5
5
  "type": "module",
6
6
  "files": [
package/steering/design-html/skills/make-a-deck/SKILL.md CHANGED
@@ -26,7 +26,9 @@ available-agents:
26
26
 
27
27
  - 先写完整标题序列放进 `scratchpad.md`。只读标题就应能看懂整份 deck 的逻辑（像书的目录）。检查是否形成清楚路径：背景 → 问题 → 洞察 → 方案 → 证据 → 下一步。
28
28
  - 选定一种标题语法并全程一致：要么名词短语（"市场机会""产品架构"），要么简短判断句（"新用户增长主要来自自然流量"）。
29
+ - 大字号标题需要换行时，按语义短语断行，避免单字成行、标点出现在行首或拆开固定短语；可通过调整文本区、字号或断行位置修正失衡。
29
30
  - 每页正文只服务本页标题，不塞旁支。封面、章节页、转场页、结尾页也要服务故事，不做纯装饰。
31
+ - 文字要有明确功能：保留承担信息、导航、出处或真实品牌识别作用的文字；不为营造风格或填补空间而编造、重复无信息价值的辅助文字。
30
32
 
31
33
  避免这些"AI 味"标题（它们会暴露 deck 是 AI 生成的）——标题的任务是**定位页面、推进叙事**，不是替演讲者甩结论 / 喊 punchline：
32
34
 
@@ -79,13 +81,14 @@ deck 每页先判断它要让观众完成什么阅读动作：抓结论、看证
79
81
 
80
82
  视觉服务演示场景，不是网页首页。
81
83
 
84
+ - **主题与风格**：根据主题、受众和演示场景提炼视觉关键词，用它们决定配色、字体、图片类型和页面节奏；不把“干净、专业”默认等同于大量留白或通用企业风。
82
85
  - **明暗按需求选择**：根据品牌 / 主题 / 图片素材 / 演示场景选择浅色、暗色或混合背景。无论选择哪种，都要保证投影、截图和后排阅读的对比度。明暗切换应落在叙事节点上（章节转换、关键强调），不要无来由地跳变。
83
86
  - 字体克制（1-2 套）：展示字体可有个性，正文必须稳定可读；整体对比清楚、信息块边界明确。
84
87
  - 图片先判断内容和用途：摄影 / 氛围图可满版裁切；截图、图表、产品界面、架构图必须完整展示（aspect-fit），不能裁掉关键边界或文字；透明图 / 细线图放到有对比的底色上。图上压字用品牌常见方式保护可读性（遮罩、渐变、模糊或文字容器）。
85
88
  - 视觉要有节奏变化：全图页、大数字页、表格页、引用页、流程页、文字页交替出现；不要整套都是同一种卡片。也不要每页硬加描边卡片、固定结论框或装饰分割线——只有内容需要分组时才用容器。
86
89
  - 扁平基线：好的 deck 不依赖阴影和悬浮卡片堆叠。优先用全页背景、色带、分隔线、编号、表格网格、图片裁切、对比色块和尺度差建立层次。只有在需要表达真实物件、票券、照片或舞台层次时才少量使用阴影。
87
90
  - 不用 emoji、不临时手绘复杂假图；优先用用户素材、品牌资产、图标库或真实图片。
88
- - **空间重心**：内容集中在上方 2/3、底部留白，通常是**正确**的 slide 构图。看到 `align-items: flex-start` 加底部留空就想改成 `center`——那是网页设计的条件反射，忍住，留白是有意的。但留白有下界：内容页的主内容应占版心高度约 2/3 以上，撑不满就升格版式——放大成大数字、大卡片，或重排为居中的宣言页，而不是把原内容原样居中或任其悬浮在顶部。空本身不是缺陷，不均才是：同一页一处大空、一处拥挤，要重排。双栏页两列视觉重量要对等，悬殊时改 7:5 / 8:4 不对称栅格或并回单栏。
91
+ - **空间重心**：页面元素应形成完整构图：留白有明确作用，独立元素与主体有可感知的关系，多栏内容在视觉重量和内容关系上协调。不预设内容必须集中在上方或占据固定比例。内容不足以独立成页时，合并、重构或升格为确有价值的观点页，不单纯放大数字、卡片或增加留白撑页。
89
92
 
90
93
  ## HTML 实现（deck-stage 外壳）
91
94
 
@@ -114,7 +117,8 @@ deck 每页先判断它要让观众完成什么阅读动作：抓结论、看证
114
117
  ## 交付前自检
115
118
 
116
119
  - 每页 16:9，无溢出 / 重叠 / 裁切；字号符合投影阅读（正文没有小到像网页）。
117
- - 留白均匀：同一页没有一处大空、一处拥挤；内容页主内容占版心高度约 2/3 以上；双栏视觉重量对等。
120
+ - 构图完整：留白与主体关系明确，没有孤立漂浮、局部拥挤或失衡的多栏布局。
121
+ - 页码、来源和固定页脚不与正文争用空间；逐页检查文字、图片和固定元素没有遮挡或碰撞。
118
122
  - 只读标题能讲通故事；标题语法全程一致，没有 punchline / takeaway 盒子。
119
123
  - 已建立 page-type map，并通过页型轮换避免单一上下布局。
120
124
  - 章节分隔页推动叙事，而不是只做装饰。