PLAN · 优化方案

优化方案:三文件协同升级

以"模板为唯一事实源、文档同步固化、占位符接口化"为原则,覆盖全部 14 项问题
3
升级文件数
v2.0
SKILL.md 目标版本
+5
新增组件(callout/steps/timeline/progress/tags)
+6
新增占位符

方案一:SKILL.md 文档层(解决 #01/#02/#03/#06/#11/#12)

优化动作具体内容对应问题
精简 description压缩至 150 字内:定位句 + 产出结构 + 场景 + 触发词,去除重复堆砌#01
统一章节定义新增"产出结构"表,明确 1 首页 + 8 内容页 = 9 文件,文件名 01-08.html 规范化#02
同步 CSS 变量设计规范直接拷贝模板完整变量(含 --redD/--redBg 等衍生色),标注"与 page-template.html 完全一致"#03
结构化 metadatafrontmatter 增加 version/tags/allowed-tools,支持版本管理与工具权限约束#06
占位符体系新增占位符总表(18+ 项),明确"生成后必须全部替换、不留 {{}} 残留"#11
扩充 Pitfalls新增 canvas 容器高度、CDN 降级说明、占位符清理、版本一致性 4 项;Verification 增至 9 项#12

方案二:page-template.html 组件层(解决 #04/#05/#07/#08/#09)

优化动作具体内容对应问题
导航体系顶部胶囊导航(返回目录/上一章/下一章)+ 页脚导航,{{PREV_FILE}}/{{NEXT_FILE}} 占位符驱动#04
内置组件库新增 callout(结论/注意/提示)、时间线、步骤图、进度条、标签 5 类组件样式,即插即用#05
图表容器修复.chart-box 增加 min-height:280px,移动端 220px,配合 maintainAspectRatio:false#07
Chart 公共配置Chart.defaults 统一字体/颜色/legend usePointStyle,各页图表样式自动一致#08
打印样式@media print 隐藏导航、去阴影、卡片避免分页断裂#09
布局收敛body 增加 max-width:1080px,大屏阅读不铺满#13

方案三:index-template.html 目录层(解决 #09/#10/#14)

优化动作具体内容对应问题
响应式网格grid-template-columns 改为 repeat(auto-fit,minmax(300px,1fr)),2 列/3 列/单列自动适配章节数量#10
hero 视觉精修增加径向渐变光晕、高亮词渐变(青→靛)、标签加边框,与内容页衔接更自然#13
卡片交互增强hover 上浮 + 左侧描边 + 箭头位移,::before 过渡动画#10
统一字体权重引入 300-900 全权重,与 page-template 一致#14
打印样式@media print 卡片避免分页断裂#09

前后对比速览

能力维度优化前 v1.0优化后 v2.0
description 长度约 200 字关键词堆砌约 150 字结构化描述
章节定义"8 章节"与表格 9 项矛盾"1 首页 + 8 内容页 = 9 文件"统一
内置组件卡片/表格/图表 3 类8 类(+callout/时间线/步骤/进度条/标签)
页面导航无顶部导航 + 页脚导航双通道
Chart 配置每页手写,样式漂移公共默认值,全局统一
打印适配无双模板均支持
占位符管理隐式约定SKILL.md 占位符总表 18+ 项
版本管理无版本字段version: 2.0.0 + tags + allowed-tools

执行时间线

第 1 步
SKILL.md 重写
精简描述、补 metadata、统一结构、占位符表、Pitfalls/Verification 扩充(203 行 → 210 行)
第 2 步
page-template 升级
导航 + 5 组件 + Chart 公共配置 + 打印样式(140 行 → 225 行)
第 3 步
index-template 升级
响应式网格 + hero 光晕 + hover 精修 + 打印样式(56 行 → 75 行)
第 4 步
本报告生成
以优化后模板体系产出 4 页 HTML 调研报告,实证新能力
结论三文件协同升级:SKILL.md 定规范与流程、page-template 提供表达力、index-template 负责呈现入口。任何一处的样式变更都应回写 SKILL.md 设计规范,形成闭环。