工件设计原则
当技能产生面向用户的工件时使用此层:HTML 报告、Markdown 教程、审查查看器、仪表板、截图、表格、幻灯片式页面或生成的技能概览页。
原则
输出质量是技能质量的一部分。生成的技能不仅应该知道要做什么;还应该知道其最终工件应如何阅读、扫描并在审查中经得起检验。
视觉系统必须遵循工件的用途。不要仅仅因为参考技能使用某种固定风格就继承它。例如,Kami 的论文编辑纪律是有用的,但其温暖的羊皮纸背景不是 Yao 生成工件的默认要求。
从文档技能借鉴什么
- 在设计页面之前按工件类型路由
- 在格式化之前提取事实、主张、数字、行动和缺失输入
- 当工件缺少必要的受众、输入或输出标准时,问一个聚焦的问题
- 保持散文、布局和生产检查分离
- 在交付前验证占位符、标题、路径、截图和渲染关键假设
从演示技能借鉴什么
- 在编写 HTML 之前规划工件的角色、层级、密度、节奏和证据
- 从主题选择具体的视觉方向,而非通用 AI 模板
- 在装饰之前使用结构、间距、字体和对比度
- 拆分密集内容,而不是把它挤到一个表面上
- 拒绝通用的紫色渐变、玻璃卡片、重复卡片网格和装饰性截图
内容主导的视觉方向
从工作本身选择设计系统:
- 高信任报告:克制的编辑布局、强层级、紧凑证据块
- 教程:清晰的渐进章节、成功检查、仅在真实且必要时使用截图
- 仪表板:紧凑指标、可见变化、简短解释、避免段落式表格
- 审查查看器:并排比较、审查者可见的证据、明确的权衡
- 幻灯片式工件:节奏、章节分隔、大主张、受控密度
不可妥协项
- 标题必须针对用户的领域和成果具体化
- 仅当比较是主要工作时才使用表格
- 引用和脚注不得打断正常阅读
- 截图和视觉证据必须真实、可溯源并正确描述
- 最终 HTML 不得包含绝对的本地文件系统路径
- 移动端和窄宽度阅读必须保持可用
- 设计 token 必须命名且连贯:字体、颜色、间距、表面和强调
审查者规则
审查者应看到工件的预期视觉方向和可能让输出显得低质量的首要风险。如果报告看起来精致但隐藏了薄弱的标题、糟糕的表格、错误的截图或引用杂乱,技能就没有准备好。