| name | ppt-page-polish |
| description | 当单页结构基本正确,但视觉上过空、过挤、层级不清或风格执行不到位,需要只对该页做细化抛光时使用。 |
PPT 单页抛光
ppt-review 发现某页视觉质量不达标但叙事结构无需改动时,进入本 skill 做 HTML 级视觉修复。
目标
在不改变页面核心叙事的前提下,修复单页视觉质量,直接修改对应的 pages/page_XX.html。
触发条件
ppt-review 判定某页信息过空或信息过挤
ppt-review 判定某页视觉层级不清、元素碰撞或溢出安全区
ppt-review 判定某页与 style-spec.json 的执行偏差明显
ppt-review 判定某页缺少背景装饰层或前景装饰层
ppt-review 判定某页组件皮肤退化为默认白卡片
- 用户主动要求对某页做视觉调整
输入
- 目标页面的
pages/page_XX.html(必须已存在)
style-spec.json(必须已存在,用于核对风格执行)
storyboard.json(必须已存在,用于确认页面叙事不变)
- 可选的
asset-plan.json(用于确认图片槽位状态)
输出
- 更新后的
pages/page_XX.html
- 如果抛光中发现超出视觉范围的问题(如叙事缺失、资产缺失),在完成反馈中标注残留问题并建议转到对应 skill
可处理问题
- 信息过空:内容区域留白过多,承载不足
- 信息过挤:文字或组件堆叠,缺少呼吸空间
- 视觉层级不清:标题、正文、辅助信息之间缺少对比
- 与
style-spec.json 的执行偏差:配色、字体、组件皮肤未忠实消费
- 元素碰撞或安全区问题:内容侵入页脚安全区或边缘溢出
- 缺少装饰层:背景或前景 motif 缺失或退化为不可感知
- 组件皮肤退化:卡片、面板、表格等退回默认样式
执行规则
1. 依赖检查
- 确认目标页面 HTML 文件存在且可读。
- 确认
style-spec.json 存在且可读。
- 读取
storyboard.json 对应 page_id,确认页面叙事角色和 payload_budget。
2. 问题诊断
3. 修复执行
- 按以下优先级逐项修复:
- 结构性问题:安全区侵犯、画布溢出、层级结构缺失
- 风格执行偏差:配色、字体、组件皮肤
- 装饰层缺失:补齐
bg-motif 和 fg-motif
- 密度与层级:调整留白、间距、字号对比
- 细节打磨:对齐、圆角、阴影、过渡一致性
4. 修复验证
- 修复后重新过一遍诊断清单,确认所有项通过。
- 确认修复未改变页面承载的核心内容和叙事角色。
- 确认修复后的页面与同 deck 其他页面保持同一视觉系统。
用户回显
- 开始反馈:说明当前锁定的页面和主要抛光问题。
- 完成反馈:概括本页做了哪些视觉调整、还有没有残留问题,以及
下一步。
关键原则
- 不要趁机改写整套叙事。
- 优先通过层级、密度、留白、视觉对比解决问题。
- 保持与同 deck 其他页面的设计语言一致。
- 必须忠实消费
style-spec.json 的字段,不要退回通用默认样式。
- 背景装饰层必须是用户可感知的视觉层,不能退化成微小角标或极淡纹理。
- 修复范围仅限视觉层面;如果发现叙事、资产或规划层面的问题,标注残留并建议转到对应 skill。
禁止事项
- 不要修改页面的核心叙事内容或
content_blocks 语义。
- 不要修改其他页面的 HTML。
- 不要删减
payload_budget 要求的承载内容来"解决"过挤问题。
- 不要用
position: absolute + transform: translate(...) 布局流式内容。
- 不要用
mt-auto、flex-grow 或 flex: 1 伪造间距。
- 不要把所有组件退回成纯色背景 + 白卡片。
- 不要为了"简洁"删掉 motif 装饰层。