单文件 · 离线可用
◆ 基于四项官方办公技能的实操指南 · 含交互效果展示

WorkBuddy 办公技能
使用及实践

不是「让模型写一段像模像样的文字」,而是把意图路由到专用流水线,产出可打开、可编辑、可复核的本地 Office 文件。本页拆解四个技能的触发方式、真实工作流与能力边界,并用页面内的高保真交互 Demo 直接展示交付效果。

workbuddy-docx DOCX 创作 / 美化 workbuddy-sheet-generation 新建 XLSX workbuddy-pptx PPT 生成 / 理解 / 编辑 workbuddy-pdf PDF 只读理解
4专业办公技能
1统一路由入口
3类任务性质:新建 / 理解 / 编辑
4段可交互效果演示
01 PANORAMA / 全景认知

先过路由,再谈技能

四个技能不是四个并列按钮。任何涉及本地 Office / PDF 文件的请求,都会先经过 workbuddy-office-routing:按文件类型 × 任务性质判定,再分派到对应技能。理解这张表,比记住四个名字更重要——大多数「用错了」的问题都出在这一步。

路由决策表(节选)
新建 DOCX:写 / 起草 / 撰写 / 重写纯意图,无源材料→docx · full_pipeline
整篇抽象美化:美化一下 / 更专业需 AI 做设计决策,无具体样式值→docx · beautify_only
既有 DOCX 改动 / 润色「把标题改成 XX」「字体改宋体五号」→local-office-edit
生成一份全新 XLSX「另做一份汇总表」,源表只读→sheet-generation
改 / 分析 / 透视 / 清洗既有表源文件本身就是交付物→sheetagent / 编辑链路
PPT 生成 / 看懂 / 改稿三条路由全归一个技能→pptx
读 PDF、总结、找事实、查表格只读理解→pdf
生成 / 编辑 PDF当前不支持→改投 DOCX / Markdown
一个容易被忽略的默认规则

当用户要的是结构化文本内容——讲稿、要点、文案、摘要、报告、会议纪要——路由层会先归类为 doc,再走本地 DOCX 创建路径;只有用户明确说「输出 Markdown / 纯文本」时才改用别的格式。

换句话说:「帮我写一份季度复盘」默认给你 .docx,而不是聊天窗口里的一段长文本。这是通用对话与办公技能最直观的区别。
任务性质的三分法
新建
产出独立新文件,路径与源文件不同
理解
只读,不改源文件,结论可定位
编辑
在既有文件上原位改动,源文件即交付物
「在这个工作簿里加一个汇总 sheet」属于编辑,不是新建——这是 Excel 路由里最常判错的一条。
能力矩阵
技能产出物关键机制读 / 写最需要注意的边界
docx
Word
本地 .docx,自动封面 + 目录 + 专业排版三段流水线 md → html → docx,每个阶段真委派写不接收源材料;具体样式修改属编辑,会转交别的技能
sheet-generation
Excel
全新 .xlsx,公式可联动、带合规标识openpyxl 直写 + 设计准则 + 场景范式 + 公式重算写只做「新文件」;源文件只读,绝不写回
pptx
PPT
.pptx,逐页生成、实时预览需求对齐 → 风格路由 → 逐页闭环(写页 → 校验 → 提交)读 + 写理解链路只读;编辑链路须先查工具 schema
pdf
PDF
结论 / 摘录 / 结构化数据,而非新文件6 种提取格式,必要时渲染页图核对版面只读不支持生成或编辑 PDF;扫描页需本机 OCR
共性:四个技能都强调「可复核」——Word 有溯源记录,Excel 公式重算零错误,PPT 逐页校验,PDF 结论要能定位到原页。这是「办公级交付」与「生成一段文字」的分水岭。
02 WORD / 文档创作与美化

workbuddy-docx:把意图变成一份能发出去的文档

W

专业 Word 文档智能体

workbuddy-docx → tdoc-orchestrator → doc-writer / doc-formatter / doc-converter

端到端覆盖研报、年报、论文、公文、合同、商务报告、会议纪要等垂类文档;从零创作、整篇美化、导出 .docx。核心不是「写得好」,而是三段流水线类型严格衔接,且每个阶段由独立角色执行。

创作美化不承接编辑
触发说法
「起草 / 撰写 / 生成 / 重写一份…」
「美化一下」「重新排版」「做得更专业」
短篇创作(<1000 字)走轻量入口
输入
纯意图,不接收 DOCX / XLSX / PDF 等源材料;带源材料的文档生成走编辑链路
输出
本地 .docx;含封面、目录、层级标题、规范表格与图片、页眉页脚;转换成功后自动打开预览
三段流水线(类型衔接不可跳级)
STAGE 0意图识别判定 full_pipeline / beautify_only / 转交编辑;不可跳过
S1 · doc-writer内容创作意图 → Markdown 初稿
S2 · doc-formatter版式生成Markdown → HTML(恒为 HTML),按体裁自选风格
S3 · doc-converter格式转换HTML → DOCX,present_files 打开成品预览,链路终止
两条合法入口
入口链路触发场景
full_pipelineS1 → S2 → S3无文档 + 创作动词(写 / 起草 / 生成 / 重写)
beautify_onlyS2 → S3已有文档 + 抽象整篇美化(需 AI 做设计决策)
转交—具体样式值 / 局部修改 / 润色 → workbuddy-office-routing
判别关键:是否需要 AI 做设计决策。「专业一点」是美化;「宋体五号、1.5 倍行距」是编辑。
六条铁律(提炼)
  1. 弹性入口:每次请求都从 Stage 0 判意图,不默认走全长链路
  2. 链路不可中断:组合后必须顺序执行到 S3,中途不交付、不脱轨
  3. 真委派:每个阶段读对应角色定义后执行,禁止「顺手自己做」
  4. 只管路由与衔接:编排层不干预子角色内部决策
  5. 中间产物不展示:md / html 只给路径,唯一成品是 .docx
  6. 溯源必写:pipeline-state.yaml 每阶段先更新再声明检查点
实践案例 · 一次真实对话
用户
帮我起草一份《2026 年度研发效能复盘》研报,要有封面、目录,中间放一张关键指标表。
智能体
Stage 0 识别:full_pipeline(无文档 + 创作动词)→ S1 产出 Markdown 初稿 → S2 按研报体裁生成 HTML 版式 → S3 转换并打开预览。
DOCX 2026年度研发效能复盘.docx 自动预览
效果展示 · 版式要素定位

右侧 Demo 是 S2 产出的 HTML 版式经 S3 转成 .docx 后的视觉结果。点击右侧清单,可在页面上定位对应版式要素——这正是「美化」技能实际负责的部分。

边界提醒:S3 是本轮链路终点。生成完成后再说「顺便把标题改一下」属于下一轮请求,会重新路由到编辑链路,而不是在流水线里续做。
TIP 想要版式稳定,第一轮就把「封面 / 目录 / 表格 / 页眉页脚」一次说清
效果展示 · Word 研报版式
S2 → S3可交互
研发中心 · 技术复盘系列INTERNAL
内部资料 · 请勿外传

AI 原生研发工作流
落地实践与效能评估

编制:研发中心 | 版本 V1.2 | 2026-11-10
一、背景与目标

本报告面向 2026 年度研发效能复盘,覆盖需求交付周期、代码生成采纳率与缺陷回归率三类指标。数据口径统一为季度汇总,剔除试验性项目,以保证同比可比性。

二、关键指标
指标Q1Q2Q3Q4
需求交付周期(天)12.410.89.17.6
生成代码采纳率41%56%68%74%
缺陷回归率6.2%4.8%3.9%3.1%
综合效能指数100118136152
三、结论与建议

效能提升主要来自结构化编辑与语义索引的引入,而非单纯增加生成量。建议下一阶段把重点放在跨仓库上下文复用与回归验证自动化。

— 1 —
说明:此处为页面内高保真版式示意(纯 HTML/CSS 绘制),用于展示技能产出的视觉结构与设计决策点,非实际 .docx 文件。
03 EXCEL / 全新工作簿生成

workbuddy-sheet-generation:生成一份「能直接用」的表

X

新表生成链路

workbuddy-sheet-generation · openpyxl 直写范式

判定条件只有一个:用户要的是一份位于新路径的全新 .xlsx。参考材料可以是纯文字、PDF / DOCX / PPTX,也可以是只读的源表 (.xlsx/.xls/.csv/.tsv) 或在线文档——源文件绝不写回。主智能体读设计准则后直接编写 openpyxl 脚本一次成表,不委派子智能体。

仅新建不做原地编辑
触发说法
「生成 / 新建 / 做一份 / 整理成一份新表 / 汇总成新表」
反例:改这份表 / 加一列 / 排序 / 透视 / 清洗 → 不属于本技能
输入
纯文字需求;pdf / docx / pptx 参考;xlsx / xls / csv / tsv 只读参考;在线文档(docs.qq.com / file_id)
输出
本地 .xlsx;公式可联动、带条件格式与冻结表头;写入 OOXML 标题 + AIGC 隐式标识
五步执行流程
STEP 1推断与命名推断展示标题与绝对路径,不反问;同名文件加时间戳不覆盖
STEP 2附件预处理extract.py 统一抽取为 Markdown,图片另出缩略图
STEP 3读设计准则必读 schema_principle.md,识别场景原型并读对应范式
STEP 4编写并执行脚本openpyxl 一次成表,公式写字符串、坐标由锚点推导
STEP 5校验与交付recalc 公式零错误 → 写 AIGC 标识 → 交付
八种场景原型:按工作方式组合,不按行业套模板
记录型计划型打卡 / 进度型统计型 表单 / 打印型看板型日历 / 排程型计算模型型

一个需求可命中多个原型,按核心交付目标定主原型,其余作补充区块。例如「项目预算跟踪表」= 计划型 + 统计型 + 计算模型型。
用户只说「做个表」且无线索时,默认按记录型轻量模板处理,不主动复杂化。

设计目标只有一句:能直接用、结构清楚、公式联动、视觉克制、便于维护、不过度设计。
四条最容易踩的工程约束
  1. 坐标锚点优先:先定标题 / 表头 / 数据 / 合计的真实行号,所有公式、填充、条件格式范围都由锚点推导,禁止先写默认第 2 行再改布局。
  2. 公式写 Excel 字符串:ws['B6'] = '=SUM(B3:B5)',不在 Python 里算好写死;除法 / 比率当场带分母空值与除零保护。
  3. 类型系统落地:日期用 date 对象、金额用数值 + ¥#,##0.00、百分比存小数比例,避免全写成字符串导致公式无法求值。
  4. 颜色转换:CSS #RRGGBB 统一经 xl_color() 加 Alpha,图表颜色则传不带 # 的六位 RGB。
交付前的两道硬校验:① 含公式的工作簿必须跑 recalc.py——openpyxl 写入的公式不带缓存值,不重算就在多数预览器里显示空白;判定只看返回 JSON 的 status=success / total_errors=0,不能把 exit=0 当通过(errors_found 的退出码也是 0)。② 重算之后才能写 AIGC 隐式标识(GB 45438-2025),先打标会被重序列化覆盖。
实践案例 · 多源参考成表
用户
基于这份 Q3 季报 PDF 和明细 CSV,另做一份《2026 效能汇总》新表,要有汇总看板、明细和达成率。
智能体
命中「统计型 + 看板型」原型 → 拆为 汇总看板 / 明细 / 说明 三个 sheet,汇总引用明细;公式列写 Excel 公式并带保护;重算零错误后写标识。
XLSX 2026效能汇总.xlsx 3 个 sheet
效果展示 · 点击单元格看公式

右侧工作簿是技能产出的视觉还原。点击任意单元格,公式栏会显示它的原始内容——公式单元格显示公式本身而非算好的值,这正是「公式联动」的含义。底部可切换 sheet。

源文件只是只读参考:CSV 里的数据被读进新表,但源文件一个字节都不会被改动。
效果展示 · Excel 工作簿(3 个 sheet)
公式可联动可交互
等线11 BIU ≡ 左对齐▤ 边框◧ 填充 Σ 自动求和⇅ 筛选▣ 冻结
fx
点击单元格查看公式 · 切换 sheet 查看不同区块
说明:页面内高保真工作簿示意。表头冻结、条件格式、合计行、公式栏与 sheet 切换均为可交互还原,用于展示「结构清楚 + 公式联动 + 视觉克制」的设计准则。
04 PPT / 演示文稿

workbuddy-pptx:一个技能,三条路由

P

PPT 生成 / 理解 / 编辑

workbuddy-pptx → create-from-scratch / understand / edit-existing

所有本地 PPT 的内容工作都归这一个技能,再按任务类型分三条路径:从零或从材料生成、只读理解与问答、在既有 pptx 上改稿。生成链路会在创建空白文件后立刻打开预览,随后逐页制作,用户能实时看到进度。

生成理解编辑
路由 A
从零 / 从材料生成

6 步:需求对齐 → 素材收集(必要时联网)→ 风格路由与 DESIGN.md → 创建空白 pptx 并预览 → 逐页生成 → 结束。材料由技能自行解析,不另起一套提取。

路由 B
理解已有 PPT / 问答

只读,不修改源文件。按页给出文字、表格、图表数据与形状坐标;无法从结构确认的关系(连线方向、视觉布局)会如实说明信息不足,不靠位置或颜色猜。

路由 C
编辑既有 pptx

实时可视编辑:先打开预览 → 取真实 file_id → 用到一个工具就先查一个 schema → 调用 → 保存。页码 / 形状索引 0-based,坐标单位 pt;保存后不主动关闭文件。

生成链路的逐页闭环
01需求对齐主题 / 目标 / 受众 / 页数;只问缺失项,一轮 ≤3 问
02风格路由通用 / 学术 / 投研 / 红金政务 / 个人介绍
03逐页制作配图 → 写页 → 校验 → 提交,未通过则修同一页
04交付全部页完成即结束,不额外复检
逐页校验的硬约束:先把页面写入 pptx,再做布局检查;页下标由智能体自行维护(首页 0),不按文件名或目录排序猜测。
风格路由:先看场合,再谈配色
风格核心调性适用
通用自由设计、按需推导产品介绍、工作总结、技术分享
学术风可信、证据驱动、蓝白克制开题 / 答辩 / 科研结题
投资分析严谨、证据留痕、假设透明行业研究、投委会、尽调
红金政务风庄重、中文优先机关 / 国企汇报、党课
个人介绍具体优于形容、有节奏面试、破冰、人物分享
判断标准是是否明确属于某垂直领域;工作总结、技术分享等大多数场景走通用路线,不硬套风格。
实践案例 · 从表格到汇报
用户
把刚生成的《2026 效能汇总.xlsx》做成 12 页季度汇报,面向管理层,重点讲趋势和结论。
智能体
走「从材料生成」:读取 xlsx → 通用风格(工作总结类)→ 对齐页数与受众 → 创建空白 pptx 并打开预览 → 逐页制作(封面 / 目录 / 趋势 / 结论…),每页写完即校验。
PPTX 2026季度效能汇报.pptx 逐页实时预览
效果展示 · 幻灯片预览

右侧是逐页生成的视觉示意:点击左侧缩略图或下方按钮切换页面。缩略图由页面本体等比缩放而来,与实际页面一致。

对客沟通只用用户术语(内容大纲 / 风格设计 / 创建演示文稿 / 逐页制作 / 交付),内部实现细节不出现在进度汇报里——这是本技能明确的协作约定。
效果展示 · 12 页汇报中的 4 页节选
通用风格可交互
QUARTERLY REVIEW · 2026
研发效能
季度复盘
从工具引入到工作流重构 · 面向管理层
研发中心 | 2026 Q4
本次汇报提纲
01 季度关键指标与趋势
02 效能提升的归因分析
03 下一阶段建议与资源
02 / 12
综合效能指数持续上行
100
118
136
152
目标
Q1Q2Q3Q4基线
Q4 综合指数 152,较 Q1 提升 52%
需求交付周期由 12.4 天压缩至 7.6 天
生成代码采纳率突破 74%,且缺陷回归率同步下行
05 / 12
结论与下一阶段
+52%综合效能指数
较年初提升
−39%需求交付周期
12.4 → 7.6 天
3下阶段重点
上下文复用 / 回归自动化 / 度量口径
建议:把投入从「增加生成量」转向「提升上下文质量与验证自动化」。
12 / 12
1 / 4 点击缩略图或使用 ← → 键
说明:页面内高保真幻灯片示意(CSS 绘制 + 等比缩放缩略图),用于展示逐页生成的版式与叙事结构,非实际 .pptx 文件。
05 PDF / 只读理解

workbuddy-pdf:读完能定位到原页,才算读懂

A

PDF 阅读与结构化提取

workbuddy-pdf · 本地 CLI(run.sh / run.ps1)

只读,不做生成或编辑。覆盖总结、问答、查事实、提表格、看版面与核对图表。当前版本不支持产出 PDF 文件,也不允许用浏览器打印或第三方库自行拼一条生成链路;遇到这类需求会直接说明,并建议改投 DOCX / Markdown / 表格。

只读不生成 PDF
六种提取方式:先选路径,再读全文
目标参数说明
总结 / 问答 / 查事实-f md较快的文字提取,默认首选
只要纯文字-f txt最轻量
版面归组后的正文与表格-f md-plain走完整版面识别
段落 / 表格 / 图片结构-f structure完整版面识别
提取表格单元格-f table --table-format json输出目录;CSV 不保留合并跨度
扫描页 / 图表 / 公式核对-f png --dpi 150渲染页图,看图核对版面
重要结论要能定位到原 PDF;引用页码用文件页序,印刷页码不同时注明。structure 的 source.page 从 0 开始,Markdown 页注释与 page-0001.png 从 1 开始。
调用与排错
sh "<skill_dir>/scripts/run.sh" --help # 每份 PDF 用独立工作目录,输出路径明确指定 workdir=$(mktemp -d /tmp/pdf-read.XXXXXX) sh "<skill_dir>/scripts/run.sh" "/abs/input.pdf" \ "$workdir/content.md" -f md -q 2>"$workdir/extract.log" # 需要图片时追加 --image-dir "$workdir/images" # 加密 PDF 用 -p <password>(回复中不复述密码)
退出码含义与处置
69组件尚未就绪,后台下载中。隔几秒重试同一条命令;不要自行 pip / brew 安装同名工具替代
127本机确实无此能力,才考虑说明限制或换读取方式
0 / 2 / 3 / 4 / 5 / 6CLI 自身:成功 / 用法 / 输入输出 / PDF 无法读取 / 转换失败 / 其他异常
扫描页会被自动检测,但发布包不自带 OCR,需本机装 PaddleOCR 或 Tesseract。遇到扫描页报错不等于空白页;扫描表格的行列与合并跨度是近似识别,须核对原页。
实践案例 · 带出处的结论
用户
这份 42 页研报里,效能提升的关键结论在哪几页?把相关数据表也给我。
智能体
先用 -f md 看篇幅与章节 → 搜关键词命中处读上下文 → 表格用 -f table 提取 → 影响结论的趋势图再用 -f png 看原页核对 → 给出结论 + 页码 + 数据。
OUT 结论摘录 + 表格数据 + 页码定位 源文件不变
效果展示 · 提取格式切换

右侧模拟阅读器:切换提取格式看不同结果,点击黄色高亮看「这段结论定位到哪一页」。

最关键的一条边界:不要问「帮我导出一份 PDF」。当前不支持 PDF 生成 / 编辑,正确做法是让它把内容整理成 DOCX 或表格,再由你自行导出。
效果展示 · PDF 阅读器与结构化提取
只读可交互
PDF 2026研发效能白皮书.pdf − 100% + 3 / 42
文档目录
1 研究背景与方法
2 指标口径定义
3 实验结果
3.1 样本与分组
3.2 效能对比
3.3 归因分析
4 讨论与局限
5 结论与建议
3.2 效能对比

在统一口径下,四个季度的综合效能指数呈单调上升趋势。Q4 综合效能指数达到 152,较 Q1 提升 52%,且缺陷回归率同步下降至 3.1%,说明效率提升并未以质量下降为代价。

指标Q1Q4
交付周期(天)12.47.6
采纳率41%74%
缺陷回归率6.2%3.1%

进一步的分项回归显示,贡献主要来自结构化编辑与语义索引的引入,而非单纯增加代码生成量。该结论在第 5 章以不同样本重复验证。

— 3 —

提取结果
选择格式,查看该路径下的产出形态
点击页面中的黄色高亮,查看定位信息。
说明:页面内阅读器示意。格式按钮对应技能真实的 6 种提取路径;黄色高亮演示「结论 → 原页定位」的复核要求。本技能只读,不产出 PDF 文件。
06 END-TO-END / 组合实战

一次任务,串起四个技能

真实工作很少只用一种格式。下面是一条典型链路:PDF 取材 → Excel 结构化 → Word 成文 → PPT 表达。关键在于每一步的输出恰好是下一步能消费的输入,且每一步都停在正确的技能边界内。

1
读:PDF 取材

42 页行业研报,提取关键结论与数据表,逐条记录页码

workbuddy-pdf
2
算:生成新表

把摘录的数据做成全新 .xlsx,汇总引用明细,公式联动

sheet-generation
3
写:正式报告

起草复盘报告 .docx,带封面、目录与指标表

workbuddy-docx
4
讲:汇报 deck

以 xlsx 与报告为材料,逐页生成管理层汇报

workbuddy-pptx
5
验:可复核闭环

数字能回到原页,公式能重算,文档与幻灯片口径一致

全链路
逐轮说法示例
① 读这份研报,把「效能」相关的结论和数据表摘出来, 每条标上页码。 ② 基于刚才的数据,另做一份《效能汇总.xlsx》, 要汇总看板和明细两个 sheet。 ③ 起草一份《2026 研发效能复盘》报告,带封面和目录。 ④ 用汇总表和报告做一份 12 页的管理层汇报 PPT。

四句话分四轮,每轮都是独立的意图识别与路由。第 ② 句的「另做一份」是命中新建工作簿技能的关键信号;若改成「在这个表里加个汇总 sheet」,就会落到编辑链路。

为什么这样排
环节角色不越界的地方
PDF只读取材不要求它导出 PDF;结论保留页码便于回溯
Excel结构化中间态数字进公式而非写死,后续改口径可联动
Word正式文本纯意图创作,不塞源材料给 docx 技能
PPT表达层材料交给 pptx 技能自行解析,不预先拆成碎片
一条反例:让 PDF 技能「把结果生成一份 PDF 报告」——当前明确不支持,也不允许绕道浏览器打印或第三方库。正确做法是让它整理成 DOCX / Markdown,再由你导出。
07 PLAYGROUND / 指令生成器

把「想做什么」翻成「该怎么说」

选目标与场景,生成一段可直接粘进 WorkBuddy 的指令,同时给出它会走哪条链路、交付什么、以及要避开的说法。全部在页面内本地计算,不联网。

小提示:措辞里带上「新建 / 另做一份 / 起草 / 基于这份材料」这类动词,能显著提升路由命中率;含糊的「帮我处理一下」会触发反问。
推荐指令可直接复制
走的链路
—
预期交付
—
避坑提醒
—
08 CHEAT SHEET / 速查与避坑

一页速查,八条避坑

我想…就这么说会走哪拿到什么
写一份新 Word「起草一份《…》报告,带封面和目录」docx · S1→S2→S3本地 .docx,自动预览
让旧文档更好看「把这份文档美化一下,做得更专业」docx · beautify_only重排后的 .docx
改某个具体样式「把标题改成宋体三号」编辑链路原文件原位改动
做一张新表「基于这份 CSV 另做一份汇总表」sheet-generation新路径 .xlsx,源 CSV 不变
改现有工作簿「在这个表里加一列达成率」sheetagent / 编辑链路源文件本身被更新
做 / 看 / 改 PPT「做一份汇报」「第 3 页讲了什么」「把封面标题换了」pptx 三条路由.pptx / 只读回答 / 原位改稿
读 PDF 找结论「这份研报的关键结论在哪几页」pdf · -f md / table / png结论 + 数据 + 页码
导出 PDF(不支持)改投 DOCX / Markdown由你自行导出
八条避坑清单
把「编辑」说成「美化」「字体改宋体五号」「把第二段润色一下」有明确目标值,属编辑,会转交别的技能;只有「更专业 / 更好看」这类需 AI 做设计决策的抽象诉求才进美化链路。
给 docx 技能塞源材料从零创作链路不接收 DOCX / XLSX / PDF 附件。带材料生成文档要走编辑链路,否则会被判定为不承接并重新路由。
S3 之后还想在同一轮继续改转换完成即链路终点。后续「顺便改个标题」是下一轮请求,会重新识别意图;需要连续修改请分轮明确提出。
把「加一个 sheet」当成新建工作簿在既有工作簿内增删 / 重命名 sheet 属于原地编辑,源文件即交付物。只有产出位于新路径的独立 .xlsx 才走生成技能。
公式写完不重算就交付openpyxl 写入的公式没有缓存值,微信 / 邮件 / 多数预览器会显示空白。必须重算到 status=success, total_errors=0;且判定看 JSON,不看退出码。
先打 AIGC 标识再重算重算会整包重新序列化,先写的元数据标识会被覆盖。顺序永远是:重算 → 打标 → 交付。
编辑 PPT 时凭记忆拼参数用到一个工具就先查一个 schema,确认必填项、0-based 索引与 pt 单位;保存后不要主动 close_file,会关掉用户正在看的预览。
把扫描页报错当成空白页发布包不自带 OCR,扫描页会报错而非留白。需本机 PaddleOCR / Tesseract;扫描表格的合并跨度是近似识别,影响结论的图表务必看原页核对。
五条最佳实践
  1. 一句话里说清产物格式 + 用途 + 必要结构(封面 / 目录 / 表格 / 页数)
  2. 区分「新文件」与「改原文件」,用「另做一份」「新建」显式表达
  3. 多源材料交给目标技能自行解析,不要预先拆成零散片段
  4. 关键数字保留来源:PDF 给页码,Excel 给公式,PPT 给数据出处
  5. 交付后先打开预览核对,再做下一轮的局部修改
本页是怎么做出来的

内容依据四个技能的 SKILL.md 及其子链路原文整理(Word 编排器、Excel 设计准则、PPT 三条路由、PDF 读取规范、统一路由入口)。页面为单文件 HTML:零外部依赖、无 CDN、离线可用;四段效果展示均为原生 HTML/CSS 绘制的可交互示意,不加载任何真实 Office 二进制文件。

这也是一种实践示范:当交付物需要「能看、能点、能带走」时,一份自包含的浅色 HTML 往往比一堆附件更省心。