Office 文档生成与检查

Capability Routing

当前 Agent 原生能力优先，但必须先做能力检查：按最终交付物路由，不按 Agent 品牌路由。若当前会话实际提供内容写作、演示设计、图表或版式能力，就由当前使用的 Agent 原生能力先完成内容与视觉方案。只有用户需要可下载、可复现的 DOCX/PPTX/XLSX 文件时，才使用本 skill 的 Office API 和检查闭环。

Output Contract

把用户交付物写到 workspace/ 下；正式文件默认放 workspace/reports/，系统生成图表默认放 workspace/_system/figures/。不要把产物写到仓库根目录。

Workflow

1. 明确最终格式、受众、语言、模板、页数或篇幅，以及是否需要可编辑源文件。
2. 使用当前会话实际可用的原生能力完成内容、故事线和视觉方案；需要文献数据时再组合 ScholarAIO 的检索或写作 skill。
3. 只读取与目标格式对应的实现参考：
   • DOCX：读取 references/docx.md
   • PPTX：读取 references/pptx.md
   • XLSX：读取 references/xlsx.md
4. 用一个可重复运行的 Python 脚本生成文件。脚本与产物都放在对应 workspace 中，避免散落临时代码。
5. 运行 scholaraio document inspect <file>；发现结构问题或溢出警告时，修改脚本、重新生成并再次检查。
6. 若当前会话实际具备 Office/PDF 渲染或页面预览能力，再对所有页面或幻灯片做视觉检查。否则明确说明只完成了结构检查和启发式布局检查，不要声称已经视觉验收。
7. 向用户提供最终文件路径、格式和已完成的检查。

Inspection Commands

scholaraio document inspect workspace/reports/report.docx
scholaraio document inspect workspace/reports/presentation.pptx
scholaraio document inspect workspace/reports/data.xlsx

document inspect 是结构化检查器：

• PPTX：报告每页 shape 的位置、尺寸和内容，并给出边界/文字溢出启发式警告。
• DOCX：报告章节、段落、表格、图片和样式结构。
• XLSX：报告 sheet、数据范围、冻结窗格、合并单元格、预览和图表。

它不能代替完整的 Office 渲染器。无警告不等于视觉布局一定正确。

Composition Rules

Quality Gates

• 保留输入数据、生成脚本和最终 Office 文件，使交付可重复生成。
• 不编造引用、图表数据或缺失内容；无法核验的内容必须标注。
• DOCX 使用语义化标题样式，不用手工字号假装标题层级。
• PPTX 统一页面尺寸、边距、标题层级和视觉网格，避免默认模板堆字。
• XLSX 保留原始数据精度，显式设置数字格式、冻结表头和筛选范围。
• 检查结果失败或出现警告时，先修复再交付；不能修复时明确列出剩余问题。

Simple Conversion Escape Hatch

只有简单 Markdown → DOCX 且不需要高级排版时，才使用：

scholaraio export docx --input workspace/report.md --output workspace/reports/report.docx

即使使用快捷转换，也要运行 scholaraio document inspect。

Examples

用户说：“帮我总结文献库，交付一份 Word 简报” → 先检索和核验内容 → 读取 DOCX 参考 → 生成 DOCX → inspect → 有渲染能力时再视觉检查

用户说：“把工作区论文做成给导师汇报的 PPT” → 先组织故事线和逐页信息 → 读取 PPTX 参考 → 生成 PPTX → inspect → 逐页视觉检查

用户说：“把论文统计导出为 Excel” → 获取结构化数据 → 读取 XLSX 参考 → 生成带格式和筛选的 XLSX → inspect