产品操作手册撰写

定位与边界

把已确认的产品事实整理成目标角色能照着完成操作的培训 PPT，交付物为可编辑 PPTX。

负责：

• 从在线文档、PRD 或已确认事实中提取内容，先澄清受众与边界，再出大纲，确认后制作 PPT；
• 默认且仅基于本 skill 的固定 V3 模板 assets/pos-neutral-training-template-v3.pptx 制作，保留其主题、母版、页型与既有资产；
• 生成后跑排版体检（重叠 / 溢出 / 触底 / 末页 / partname 冲突），告警清零才交付；
• 产出演示项目档案并写入工作记录。

不负责：

• 决定产品范围、权限、字段、状态或业务规则；缺口回到源文档或用户确认；
• 把历史 PPT、旧截图、草稿或推测写成当前事实；
• 在用户当次未明确指定模板时改用其他公司模板或新建主题。

与相邻 skill 的分工

POS+ 门店场景且需要事实卡分级、蓝湖取图、渲染门禁时，改用 pos-operation-manual-skill；本 skill 面向通用产品，不重复实现蓝湖工作流。

固定模板硬规则

1. 默认且仅使用 assets/pos-neutral-training-template-v3.pptx；不得主动新建、替换或选用公司模板。
2. 只有用户当次明确指定模板类型或具体模板路径时，才改用该指定模板。
3. V3 末页（「自定义版式」）是公司 Logo 收尾页：固定、不可替换，必须原样保留为整套 PPT 最后一页，不承载任何业务内容。
4. 业务页不得建在「自定义版式」上，否则会带出母版 Logo 与标语。
5. 换模板前先跑 scripts/template_probe.py 重新探测页型与安全线，不沿用旧数值。

关键约束速查

• 内容安全底线：正文 y < 6.95″（母版标语在 6.98″）。
• 内容块一律用不透明卡片打底，遮住母版中部 Logo（y1.80–3.55）与品牌条幅（y4.40–5.31）。
• 克隆顺序：先清空模板全部页，再新增克隆页（否则 partname 重名会静默覆盖整页）。
• 详细坐标、配色、布局配方与排错见 references/ppt-cloning.md。

工作流

1. 获取来源。 在线文档优先走连接器（钉钉用 dws doc info → dws doc read）；网页抓取只返回登录外壳时立即改用连接器或索取导出件。拿到正文后立刻用 scripts/localize_images.py 把远程截图下载到本地。详见 references/source-intake.md。
2. 划分事实等级。 分为已确认 / 设计中 / 待定，PPT 中原样标注，不把假设写成事实；源文档中的空占位图按文字重绘并注明。
3. 提澄清五问。 面向受众视角、内容主线取舍、时长页数、风格品牌、配图处理各提一问并给选项，收到回复后再出大纲。模板见 references/clarify-outline.md。
4. 出大纲与叙事线确认。 先给一句话叙事线，再给页级表格（页号 / 页型 / 主题 / 核心内容 / 配图），结尾请用户确认或指定改动；收到「生成」后才动手。
5. 按模板制作 PPT。 用 scripts/pptx_kit.py 的 Deck 构建：清空 → 克隆页型 → 填内容 → 追加末页 Logo 收尾页 → 清理空图片占位 → 保存。严格沿用 V3 页型与中性配色，按 references/ppt-cloning.md 的配方控制尺寸与间距。
6. 跑排版体检。 python3 scripts/layout_check.py <输出.pptx> --safe-bottom 6.95 --closing-layout 自定义版式；任一告警修到清零，退出码非 0 不得交付。
7. 交付与归档。 产出演示项目档案、写入工作记录，并按 references/delivery.md 的回复结构汇报（交付物 / 来源与做法 / 诚信说明 / 页级结构 / 下一步演示卡）。

质量门禁

• 排版体检无告警；
• 末页为 V3 Logo 收尾页且无业务内容；
• 无残留模板占位符文本；
• 主题、母版、页型与既有资产保留，未替换模板；
• 截图已本地化并标注「设计稿示意」；待定 / 设计中项按原状态标注；
• 交付状态与事实完整度一致，不声称已发布或已上线培训。

资源

运行环境：Python 3.9+，依赖见 requirements.txt（python-pptx、pillow）。