mcpField
T
technical-presentations

technical-presentations

github.com/melodic-software文档处理2854 次安装今天更新
代码仓库

关于 technical-presentations

面向开发者的技术演示指导技能,涵盖演讲、演示、架构评审、知识分享和方案提案。它结合 What-Why-How 结构,提供幻灯片、时间安排、现场演示及问答建议。

主要功能

  1. 01What-Why-How 演讲结构
  2. 02四类演示形式指南
  3. 03幻灯片设计原则
  4. 04现场演示准备与故障应对
  5. 05问答与节奏指导

适用场景

  1. 01规划技术演讲大纲
  2. 02准备架构评审
  3. 03安排产品现场演示
  4. 04推介技术方案

安装

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

$npx skills add https://github.com/melodic-software/claude-code-plugins --skill technical-presentations

安装后在 Claude Code 中输入/technical-presentations确认已加载。

包含的文件

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

references/
demo-playbook.md
presentation-checklist.md
slide-design-guide.md

详细介绍

技术演示技能

创建引人入胜的技术演示,为开发者受众传递知识、说服并激发兴趣。

关键词

演示、幻灯片、演讲、演示、公开演讲、提案、架构评审、技术分享、午餐分享、闪电演讲、会议、聚会、powerpoint、keynote、google slides

何时使用此技能

当开发者需要以下帮助时,此技能可提供指导:

  • 构建技术演示或演讲
  • 为开发者受众制作有效的幻灯片
  • 规划并执行现场演示
  • 展示架构决策或提案
  • 举办知识分享活动
  • 向利益相关者推介技术解决方案

核心框架:是什么—为什么—怎么做

每场技术演示都应遵循以下结构:

┌─────────────────────────────────────────────────────────────┐
│  WHAT (10% of time) - The Hook                              │
│  "Here's the problem/opportunity we're addressing"          │
├─────────────────────────────────────────────────────────────┤
│  WHY (30% of time) - The Context                            │
│  "Here's why it matters and why you should care"            │
├─────────────────────────────────────────────────────────────┤
│  HOW (50% of time) - The Solution                           │
│  "Here's how we solve it / how it works"                    │
├─────────────────────────────────────────────────────────────┤
│  CLOSE (10% of time) - The Call to Action                   │
│  "Here's what you should do next / key takeaways"           │
└─────────────────────────────────────────────────────────────┘
是什么:引入主题(前 2-3 分钟)

目标: 吸引注意力并说明主题的相关性。

技巧:

  • 从受众熟悉的问题切入
  • 以令人惊讶的统计数据或事实开场
  • 提出一个发人深省的问题
  • 讲述一个简短故事,展现问题带来的困扰

避免以下做法:

  • “今天我要讲的是……”
  • 尚未吸引受众就先展示议程幻灯片
  • 一开始就讲定义或背景
  • 为任何事情道歉
为什么:背景(接下来的 30% 时间)

目标: 说明这件事为何重要。

包括:

  • 理解主题所必需的背景
  • 利害关系(如果我们不采取行动会怎样)
  • 机遇(有哪些可能性)
  • 为什么是现在(紧迫性或时机)

根据受众调整:

  • 技术同行:减少背景,深入细节
  • 混合受众:增加背景,减少术语
  • 管理层:聚焦业务影响
怎么做:解决方案(主体内容 - 50%)

目标: 呈现核心内容。

结构选项:

  • 按时间顺序(整个过程)
  • 问题 → 解决方案 → 证据
  • 以示例说明三个关键要点
  • 之前 → 改变 → 之后

技术内容可包括:

  • 架构图
  • 代码示例(简化版)
  • 现场演示(准备备用方案)
  • 指标和数据
收尾:行动号召(最后 10%)

目标: 加深印象并推动行动。

包括:

  • 总结(最多 3 个关键要点)
  • 明确的后续步骤
  • 深入了解的资源
  • 问答时间

演示类型

类型 1:架构评审 / RFC

目的: 获取对技术方案的反馈。

结构:

  1. 问题陈述(2 分钟)
  2. 限制条件和要求(3 分钟)
  3. 考虑过的选项(5 分钟)
  4. 提议的解决方案(10 分钟)
  5. 承认权衡取舍(3 分钟)
  6. 未解决的问题(2 分钟)
  7. 讨论(15 分钟以上)

成功关键:

  • 提前分享材料
  • 聚焦决策,而非实现细节
  • 明确指出你不会做什么
  • 为尖锐问题做好准备
类型 2:演示 / 演练

目的: 展示某项功能的运作方式。

结构:

  1. 此方案解决的问题(2 分钟)
  2. 简要概览(3 分钟)
  3. 现场演示(15-20 分钟)
  4. 深入了解实现原理(可选,5-10 分钟)
  5. 问答(5-10 分钟)

成功关键:

  • 始终准备备用方案(截图、视频)
  • 使用真实但安全的数据
  • 操作时同步讲解
  • 准备好故障时的回滚方案
类型 3:知识分享 / 午餐分享

目的: 教授实用知识。

结构:

  1. 此主题为何重要(3 分钟)
  2. 核心概念(10 分钟)
  3. 实际应用(10 分钟)
  4. 易踩的坑和技巧(5 分钟)
  5. 资源和问答(5 分钟)

成功关键:

  • 了解受众的水平
  • 提供可执行的收获
  • 提供后续学习资源
  • 让活动具有互动性
类型 4:决策提案

目的: 为提案争取支持。

结构:

  1. 问题 / 机遇(3 分钟)
  2. 我们考虑过的选项(5 分钟)
  3. 我们的建议(10 分钟)
  4. 相较于其他方案的优势(5 分钟)
  5. 风险缓解措施(3 分钟)
  6. 请求做出决策 / 确定后续步骤(2 分钟)

成功关键:

  • 开门见山地提出建议(不要把它藏在后面)
  • 预判异议
  • 准备数据支持论点
  • 明确说明你的诉求

幻灯片设计原则

规则
  1. 每张幻灯片只讲一个观点 - 如果标题里需要用“和”,就拆开
  2. 每条项目符号 5-7 个词 - 幻灯片是提示,不是讲稿
  3. 视觉优先于文字 - 使用图表、截图、代码
  4. 设计保持一致 - 使用相同的字体、颜色和版式
  5. 坐在后排也能看清 - 正文至少使用 24pt
有效做法
元素好不好
标题以行动为导向,具体明确泛泛而谈,含糊不清
项目符号关键词和短语完整句子
图表简洁明了,带有标注信息繁杂,标注太小
代码突出显示关键行展示完整文件
数据一个明确的要点多张图表
幻灯片类型

标题页: 主题、姓名、日期、背景信息

议程页: 谨慎使用,放在开场引入之后

内容页: 一个观点及其支撑内容

图表页: 以视觉内容为主,文字尽量少

代码页: 语法高亮,标出关键行

总结页: 3 个关键要点

问答页: 邀请观众提问

现场演示最佳实践

准备工作
  • 演示当天早上测试所有内容
  • 准备好截图或视频作为备用
  • 使用真实但安全的数据
  • 增大字体(终端至少使用 18pt)
  • 关闭通知
  • 提前打开并整理好浏览器标签页和窗口
  • 制定故障应对方案
执行过程
  • 讲解你正在做什么
  • 停顿片刻,让观众跟上
  • 指出应该关注的内容
  • 出现问题时坦然面对
  • 准备好“脱困”方案
出现故障时
  1. 简短说明情况
  2. 尝试快速修复一次(最多 30 秒)
  3. 如果仍未修复,切换到备用方案
  4. 自信地继续
  5. 不要过度道歉

应对问答

技巧

重复问题: 确保所有人都听清,也给自己留出思考时间。

必要时澄清: “你问的是 X 还是 Y?”

肯定好问题: “这个观点很不错……”

不知道也没关系: “这个问题我目前没有答案,但我可以去查一下。”

必要时延后讨论: “这是个更大的话题,我们可以会后讨论。”

关联到自己的观点: “这和刚才提到的观点有关……”

棘手问题
类型回应
质疑你的做法“这个担忧很合理。我们是这样考虑的……”
超出讨论范围“问得好——这不在我们讨论的范围内。我们可以会后再聊。”
语气充满敌意保持冷静,回应问题内容,而不是语气
炫耀型提问“这个观点很有意思。我来谈谈实际方面……”
没有明确问题的冗长发言“我确认一下自己是否理解了你的问题……”

时间安排与节奏

时间分配
时长内容问答
5-10 分钟(闪电演讲)8 分钟不安排或 2 分钟
20-30 分钟(标准)20-25 分钟5-10 分钟
45-60 分钟(深入讲解)35-45 分钟10-15 分钟
节奏建议
  • 开场有力(不要浪费开场时间)
  • 调整演讲状态(避免语调单一)
  • 层层递进,引出关键观点
  • 有策略地运用沉默
  • 准时结束(或提前结束!)
练习流程
  1. 通读: 为自己朗读幻灯片并计时
  2. 口述: 不看幻灯片练习讲解
  3. 完整演练: 向他人演讲或录下自己的演讲
  4. 果断删减: 如果超时,就删掉部分内容

参考资料

如需详细指导,请参阅:

  • references/slide-design-guide.md - 全面的幻灯片制作指南
  • references/demo-playbook.md - 现场演示的准备与执行指南
  • references/presentation-checklist.md - 演讲前的准备清单

相关命令

  • /soft-skills:structure-presentation - 生成演讲大纲
  • /soft-skills:write-cfp - 撰写会议提案

应避免的反模式

  • 以“今天我将谈谈……”开场
  • 逐字朗读幻灯片
  • 幻灯片上的文字太多
  • 现场演示没有备用方案
  • 演讲超时
  • 为内容道歉
  • 跳过问答环节
  • 没有明确的要点总结

版本历史

  • v1.0.0(2025-12-26):首次发布

最后更新

日期: 2025-12-26 模型: claude-opus-4-5-20251101

评论

支持 Markdown