研报 PPT 生成技能
把研究报告、咨询备忘录等结构化内容,转换为高密度、可交付级的投研/咨询 PPT,全程强制内容忠实与多步确认。
SKILL.md 展示了良好的安全设计:每一步都有显式用户确认门(G1)、内容忠实规则禁止捏造数据(G3)、状态文件支持中断回滚(G2 与 Resume Protocol)、使用不可编辑图表时明确警示用户(G5)。但并非最小权限实现:依赖 ~/.claude/skills/pptx 下未在此仓库提供的脚本与工作流,其行为无法在静态审查中核实;无独立的敏感数据处理说明。扣除外部依赖不可见、敏感数据流说明缺失。
指令自洽、状态机与恢复协议清晰,失败时提示回退路径。但依赖硬编码路径(~/.claude/skills/pptx/scripts/...)与外部 pptx 技能的 QA 协议,若这些文件缺失或路径不同则关键路径不可复现;错误处理与异常输入反馈仅依赖外部文档,未见针对性说明;无任何测试证据。静态上限 10 以下。
触发词明确(含中文触发词),frontmatter 明确声明了不适配范围(不做通用演示、不编辑已有 PPTX、不做路演 pitch),输入与预期输出有描述。但环境适配依赖本地 Node.js/LibreOffice/poppler/markitdown 全套工具链,未提供安装验证或环境检查;核心渲染依赖的 pptx 技能不可达时技能基本不可用,此风险未披露。
信息架构分层良好(渐进式加载:仅读当前步骤参考文件),README 提供安装说明、文件结构、设计原则。但缺少版本号/变更日志、维护责任与更新路径;license 元数据为 unknown,README 声称 MIT 但仓库层证据不完整;参考文件未在本次审查材料中提供,隐藏假设无法核实。
声称产出高密度可编辑图表的研究型 PPTX,价值主张清晰且与手动制作相比有明确边际价值;设计规则具体可执行。但无任何已生成示例、截图或验证过的输出,输出可直接可用性未证实,静态审查下不能给出更高分。
仅有作者自述的设计文档;无测试套件、无 CI 证据、无第三方执行记录、无示例输出可供复核。事实与推断基本可分(规则明确),但关键主张(QA 循环有效性、渲染质量)完全不可独立验证。
- 技能硬编码依赖 ~/.claude/skills/pptx 下的脚本与文档,未安装配套 pptx 技能时无法运行,请先确认依赖存在。
- 需要本地安装 Node.js、LibreOffice、poppler、markitdown、pdfplumber 等工具链,且 Step 3b 事实核查依赖联网搜索能力。
- license 在仓库元数据中为 unknown,README 仅口头声明 MIT,使用前请核实法律条款。
- 无版本号与变更日志,且参考文件未随本次审查材料提供,实际步骤内容未经核实。
- 无示例输出或测试证据,产出质量需用户自行验证。
这个 Skill 能做什么,适合哪些场景?
这是一个面向投研与咨询场景的 Claude Code 技能,用于生成高密度、图表密集的 PPTX 报告。它通过六步流水线(内容输入、格式选择、大纲、每页故事线、逻辑与事实复核、分章渲染)推进,每一步都需要用户明确确认。技能强约束内容忠实——不虚构数据,内容缺口显式标记;同时复用基础 pptx 技能的渲染与 QA 基础设施。断点续传由 _deck_state. 状态文件支持,适合长流程的中断恢复。
读取用户提供的结构化内容(如 docx 报告、PDF),先做内容充分性评估;在每一步生成大纲、每页以结论为导向的标题与关键信息,并对故事线做逻辑与事实核查(可联网验证)。渲染阶段根据是否提供 PPTX 模板选择 XML 编辑或 PptxGenJS 从零构建,最大化原生可编辑图表,每章渲染后执行内容 QA(markitdown)与视觉 QA(soffice 转 PDF 转 PNG 后检查)。每步结束后将进度写入 _deck_state.,重启时可检测状态并从断点续做或回滚。
- 券商/基金分析师需要把一份研究备忘录转成可在内部路演评审使用的图表密集型投研 PPT
- 咨询顾问需要基于已有分析产出一份结构清晰的行业分析交付物幻灯片
- 投行团队需要生成股权研究报告演示页,要求每页图表配分析性评注而非堆砌大数字
- 行业研究人员需要对内容先做事实核查再制图排版的研究报告 PPT
- 长流程制稿用户希望在生成中途断开后能从上一步状态恢复继续
这个 Skill 有哪些优点和局限?
- 每一步与每一章渲染都有强制用户确认门,流程可控、可纠偏
- 内容忠实约束严格,不虚构数据,内容缺口显式标记
- 状态持久化到 _deck_state.,支持中断恢复与回滚到任意步骤
- 最大化原生可编辑图表,交付物可在 PowerPoint 中继续编辑
- 逻辑复核(3b 步)前置到视觉设计之前,避免返工
- 强依赖基础 pptx 技能(~/.claude/skills/pptx/),需先安装且文档未说明其安装方式
- 依赖链较重:Node.js、LibreOffice、poppler、多个 Python 包缺一不可
- 事实核查步骤需要联网搜索能力,离线环境无法完成 3b 步
- 仓库无描述、无 topics,License 字段未知(README 声称 MIT,但仓库元数据未确认)
- 无测试套件,无实际生成样例或截图作为质量证据
- 明确不适用于通用 PPT 创建、已有 PPT 编辑或路演/融资 Pitch 风格
如何安装这个 Skill?
将仓库克隆到技能目录:
git clone https://github.com/zhangxinrui127-stack/pptx-research.git ~/.claude/skills/pptx-research
前置依赖:Node.js、LibreOffice (soffice)、pdftoppm (poppler)、Python 包 pdfplumber 和 markitdown。该技能复用基础 pptx 技能(需位于 ~/.claude/skills/pptx/),安装基础 pptx 技能是隐含前提,README 未给出其安装步骤。
如何使用这个 Skill?
在 Claude Code 中用触发语发起,例如:"Create a research deck from this report"、"Generate equity research slides"、"Build a consulting deliverable deck"(中文触发词包括研报PPT、咨询报告PPT、行研PPT等)。技能会逐步请求确认:内容充分性 → 语言与模板 → 大纲 → 每页故事线 → 逻辑/事实复核 → 每页视觉方案 → 分章渲染,每一步你都需要明确批准。中断后重启会检测 _deck_state. 并询问从哪一步继续。
这个 Skill 与同类方案有什么区别?
该技能自身明确与基础 pptx 技能区分:pptx 技能面向通用演示文稿创建与已有文件编辑,本技能专注投研/咨询的高密度信息型报告,两者为互补而非竞争关系。