mcpField
P
ppt-agent-workflow

ppt-agent-workflow

github.com/mucsbr文档处理65161 次安装8 周前更新
代码仓库

关于 ppt-agent-workflow

ppt-agent-workflow 是面向演示文稿 Agent 的技能,指导从澄清需求到调研、列纲、审阅和交付的分阶段流程。它约束工作步骤,但不限定具体执行方式。

主要功能

  1. 01澄清需求并评估能力
  2. 02调研与证据整理指导
  3. 03大纲和逐页策划流程
  4. 04完整起草前设置审阅节点
  5. 05披露限制并进行交付检查

适用场景

  1. 01将不完整主题整理为演示文稿需求
  2. 02为基于研究的演示文稿构建结构
  3. 03扩展完整演示文稿前审阅大纲
  4. 04分阶段策划高影响力演示文稿

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mucsbr/ppt-agent-workflow-san --skill ppt-agent-workflow

安装后在 Claude Code 中输入/ppt-agent-workflow确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
agent-integration.md
method.md
prompts.md

详细介绍

PPT Agent 工作流

概述

将 PPT 创作视为分阶段工作,而不是一次性生成。本技能应告诉 Agent 必须完成哪些工作,以及何时完成,同时将如何执行留给安装本技能的 Agent 及其环境。

除非特定环境有明确要求,否则不要指定具体的搜索工具、浏览器、MCP、渲染器或导出路径。

核心原则

约束工作流,而不是实现方式。

本技能应帮助 Agent 判断:

  • 简报何时仍不清晰
  • 何时需要进行最新事实调查
  • 何时应暂停并让用户审阅中间结果
  • 何时继续完善草稿
  • 能力有限时如何如实回应

能力认知

在开始实质性工作之前,大致判断当前环境能否:

  • 收集外部事实,或至少利用用户提供的材料开展工作
  • 创建结构化输出,例如笔记、大纲或规划草稿
  • 创建可供审阅的产物
  • 将文件或产物交付给用户

仅依据这些判断决定可以完成到哪个层次。不要将本节变成工具选择策略。

支持的输入方式

接受以下任意一种输入方式。

1. 仅提供主题

示例:“帮我做一个 AI 安全体检中心的 PPT”

如果输入不完整,请询问最少的缺失信息:

  • 受众
  • 目的
  • 页数范围
  • 偏好的语气或风格
  • 是否需要最新事实调查
  • 用户是否希望在完整生成前审阅中间结果
2. 主题 + 简报

适用于用户已提供受众、目的、风格、页数和关键信息的情况。

3. 基于资料的请求

适用于用户提供 URL、报告、PDF、笔记、转录稿或其他一手材料的情况。

将用户提供的材料作为主要上下文。只有在能实质性改善结果时,才补充外部事实调查。

4. 现有大纲或部分草稿

适用于用户已有结构、初版演示文稿或页面构想,并希望改进而非从头重新生成的情况。

支持的输出层次

做到用户所需的层次即可。

  1. research-brief

    • 事实、证据、待解决问题、风险,以及可提供的来源参考
  2. outline

    • 演示文稿结构、章节逻辑、页面标题和页面目标
  3. planning-draft

    • 逐页规划卡片,说明创作意图、信息层级、证据需求和布局方向
  4. sample-artifact

    • 一个或多个环境实际能够生成、可供审阅的任意形式的中间产物
  5. full-deck-plan

    • 已获批准的结构,以及足以支持完整制作的规划指导
  6. review-notes

    • 有关逻辑、证据、信息密度、一致性或重点的问题

默认工作流

1. 明确简报

仅收集避免不必要失误所需的信息:

  • 主题
  • 受众
  • 目的
  • 页数范围
  • 风格或语气
  • 必须包含的章节
  • 必须避免的主张或方向
  • 用户希望快速生成粗略版本,还是分阶段确认
2. 判断是否需要事实调查

如果出现以下情况,请先进行事实调查,再拟定大纲:

  • 主题涉及时事、市场状况、产品详情、统计数据或技术事实
  • 用户明确要求内容有研究依据
  • 用户提供的材料明显不完整

如果不需要最新事实调查,则根据已有上下文继续。

3. 收集或整理上下文

使用安装本技能的 Agent 所具备的能力,收集或整理支持材料。

如果无法进行外部事实调查,请明确说明结果受限于现有来源,并以用户提供的材料为依据,而不要杜撰确定性结论。

如有需要,请先阅读 references/agent-integration.md 和 references/prompts.md,再执行此步骤。

4. 在研究至关重要时,编写研究简报

制作演示文稿前,先将已有知识整理成一份精简简报:

  • 关键事实
  • 支持性证据
  • 与受众相关的背景
  • 风险、注意事项和未解决的问题

简报可以很短,但应为后续大纲提供更扎实的依据。

5. 先生成大纲,再进行设计

只有在简报和背景信息足够完善后,才创建演示文稿结构。

阅读 references/prompts.md,并在适当时使用“Outline Architect”提示词。

要求:

  • 保持逻辑结构
  • 确保论点与现有证据一致
  • 让演示文稿适合讲解,而不只是阅读
  • 让用户能够轻松审阅大纲
6. 添加策划稿

对于非简单的演示文稿,不要从大纲直接跳到精修页面。

创建页面级策划卡,明确说明:

  • 页面要表达的要点
  • 受众应该记住的内容
  • 所需的支持信息或证据
  • 信息层级
  • 建议采用的视觉或结构呈现方式

阅读 references/prompts.md,并在适当时使用“Planning Draft / 策划稿”提示词。

7. 在有帮助时,生成可供审阅的中间产物

在大规模扩展之前,先产出用户可以反馈的内容。

形式不作限定,例如:

  • 研究简报
  • 大纲
  • 策划稿
  • 页面示例
  • 环境实际能够支持的其他可供审阅的中间产物

如果环境或任务更适合其他产物类型,不要强行采用某一种。

8. 对重要演示文稿设置审阅关卡

以下演示文稿应设置明确的审阅关卡:

  • 面向外部的演示文稿
  • 管理层或董事会风格的演示文稿
  • 客户或销售演示文稿
  • 基于不确定或变化迅速事实的演示文稿
  • 涉及复杂技术主题的演示文稿
9. 扩展或定稿

只有在方向获得认可后,Agent 才应扩展成完整的演示文稿计划或更丰富的产物。

10. 审阅并说明限制

交付前,检查以下内容:

  • 逻辑
  • 事实可信度
  • 证据覆盖情况
  • 信息密度
  • 强调重点和层级
  • 各部分或页面之间的一致性

如果能力限制影响了结果,应明确说明。

协调规则

研究规则

如果任务依赖事实,Agent 应先收集或核实支持材料,再以肯定的语气陈述。

诚实规则

如果环境无法支持理想的工作流,Agent 应说明限制,并在当前条件下继续做到价值最高的环节。

审阅关卡规则

对于复杂或高风险任务,Agent 应先提交中间成果,再着手完成完整草稿。

不作假设规则

技能绝不能假设某一种特定的研究、渲染、预览或导出实现路径。

资源

  • references/method.md — 精简后的方法,以及分阶段制作 PPT 背后的理由
  • references/agent-integration.md — 适用于不同能力 Agent 的抽象协调规则
  • references/prompts.md — 可复用的提示词,涵盖研究、大纲、策划、审阅以及可选的特定格式生成

评论

支持 Markdown