用途
editable-figure 主要用于论文和项目提案写作中的总览图或 Figure 1。它把文档的中心思想转成读者可快速理解的图形,并交付作者可以实际编辑的 PowerPoint 源文件。独立的数据分析图表属于绘图工作流(如 Matplotlib);结果插图在有助于论证时可作为总览图的组成部分。论文、提案和 README 图共享这些原则,但服务于不同的读者决策。
主要能力
- 分析源材料:阅读相关章节及邻近文字、文档目的、已有图形和支撑主张的主要产物,写作工作简报,记录受众与放置位置、读者应记住的一句话、图的用处、必要视觉证据、内容分配与主张边界。
- 参考研究:新图或大幅改版前,先阅读个人视觉画廊并查看相关图片,区分作者已确认的偏好与候选参考;论文参考顶会论文(ML/AI 常见 NeurIPS、ICML、ICLR),README 参考当前相关活跃项目,提案优先参考作者偏好示例及本地获奖/资助收藏。
- 面向要点设计:根据信息选择视觉结构,例如带干预点的示例、随时间出现的证据、瓶颈与所提机制、输入到输出的变换或对比;不默认套用三栏、生命周期或卡片网格。
- 空间效率:按最终文档尺寸判断单位面积的有效信息,区分支撑层级的留白与无阅读功能的空白区域,回流或缩短造成多余宽度的元素,并把节省的空间还给正文。
- 配色:新图优先采用所选参考中已确认的颜色偏好和当前文档标识;无选定调色板时使用共享的 CatchBench、Cat-DPO、No Attacker Needed 色系作为回退(白底、薄荷/珊瑚对比、青绿与暖金、深色文字配安静灰色上下文)。
- 降低阅读负担:逐个标签判断其增加的信息或防止的误解,删除不影响正确阅读的文字,不为显得严谨而添加解释或警示块;保留承载主张的数字。
使用方式
该技能用于图形的编辑与设计决策。若已安装演示技能,应阅读其当前制作运行时与验证要求;否则使用可用的 PPTX 库或原生 PowerPoint 自动化,并遵循 native-powerpoint.md 的原则。工作流可与 Codex、Claude Code 或其他有能力的 agent 配合,不依赖单一模型或桌面插件。
平台要求:开始构建前需确认会话能在 Windows 或 macOS 上使用桌面 PowerPoint 完成渲染与编辑检查。python-pptx、PptxGenJS 等库可在无头环境创建原生对象,但无法确认结果能否按预期打开、渲染和编辑。捆绑的 scripts/render_powerpoint.ps1 使用 Windows COM 自动化;macOS 需可用的原生 PowerPoint 工作流。不具备该能力时,应在构建前说明限制;评估和仅提示类工作不受影响,可提供 ci-mockup-figure 作为替代(当其输出满足需求时),但除非用户同意,否则保留明确的 PPTX 交付要求,不得悄悄用扁平图片替代可编辑图形。
工作流步骤:分析源材料与读者决策 → 查找并研究参考 → 面向要点设计 → 生成整体视觉概念、选择构图、构建可编辑图层 → 在上下文中检查(渲染与编辑验证)。修订可复用已接受的构图;经授权委派时建议两个独立概念,但第二个生成器不能成为跳过第一个的理由。
适用场景
论文/提案的新总览图、独立机制图或大幅重设计;README 图;位置/框架/概念论文的压缩论证型总览图;需要可编辑 PowerPoint 源文件的图形交付。
限制
- 需要桌面 PowerPoint 环境完成渲染和编辑检查;无头环境无法完成该验证。
- 不用于独立科学数据绘图、完整演示文稿制作、HTML 模型图/截图/TikZ 等代码原生图形;这些各有对应工作流。
- 不得仅因本技能可用,就用 PPTX 替换用户明确要求的 SVG、Illustrator 文档或截图。
- 其他用户需自行确认视觉偏好;Yue Zhao 的画廊记录对其他用户只是候选。
- 不得把推断出的偏好当作已确认偏好,也不应为每个任务插入偏好问卷。