wind_power_cal/.agents/skills/edge-presentation-docs/SKILL.md

name, description

name	description
edge-presentation-docs	edge_collector PPT/汇报材料编写与处理规范。用于把方案设计、部署方案、测试结果、故障复盘、AI/本地模型方案、协议适配方案整理成汇报型 PPT 或演示大纲，并可读取、检查、转换已有 .pptx。

edge_collector 汇报材料处理

适用场景

• 方案汇报。
• 项目进展汇报。
• 故障复盘汇报。
• 部署上线说明。
• 本地模型或 AI 功能方案展示。
• 协议适配方案展示。

默认结构

1. 背景与目标
2. 当前现状/问题
3. 方案总览
4. 核心设计或流程
5. 实施计划
6. 验证结果
7. 风险与对策
8. 下一步

设计口径

• 面向工业网关和云边协同场景，风格稳重、清晰、克制。
• 优先用流程图、架构图、对比表，而不是大段文字。
• 一页只表达一个核心结论。
• 保留必要证据：截图、日志摘要、测试结果、关键指标。
• 不展示密钥、密码、真实 Token。

内容转换

从 Markdown 方案转 PPT 时：

• 每个二级标题通常对应 1 页或 1 组页。
• 长表格改成摘要表 + 附录。
• 命令行只保留关键命令和结果，不放完整日志。
• 复杂架构图优先使用 edge-svg-diagram 生成 SVG 后嵌入。

读取 PPTX

提取文本：

python3 -m markitdown input.pptx > output.md

没有 markitdown 时，先说明无法直接提取，改用 LibreOffice 或解包 XML。

检查结构：

unzip -l input.pptx | rg "ppt/slides/slide|ppt/media|ppt/theme"

交付检查

• 标题是否能单独表达结论。
• 字体和颜色是否统一。
• 截图是否清晰。
• 图表文字是否不截断。
• 每页是否有明确层级。
• 是否隐藏内部 AI 配置、密钥和调试信息。