关于 technical-presentations
面向开发者的技术演示指导技能,涵盖演讲、演示、架构评审、知识分享和方案提案。它结合 What-Why-How 结构,提供幻灯片、时间安排、现场演示及问答建议。
主要功能
- 01What-Why-How 演讲结构
- 02四类演示形式指南
- 03幻灯片设计原则
- 04现场演示准备与故障应对
- 05问答与节奏指导
适用场景
- 01规划技术演讲大纲
- 02准备架构评审
- 03安排产品现场演示
- 04推介技术方案
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ melodic-software/ claude-code-plugins --skill technical-presentations安装后在 Claude Code 中输入/technical-presentations确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/demo-playbook.mdpresentation-checklist.mdslide-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
目的: 获取对技术方案的反馈。
结构:
- 问题陈述(2 分钟)
- 限制条件和要求(3 分钟)
- 考虑过的选项(5 分钟)
- 提议的解决方案(10 分钟)
- 承认权衡取舍(3 分钟)
- 未解决的问题(2 分钟)
- 讨论(15 分钟以上)
成功关键:
- 提前分享材料
- 聚焦决策,而非实现细节
- 明确指出你不会做什么
- 为尖锐问题做好准备
类型 2:演示 / 演练
目的: 展示某项功能的运作方式。
结构:
- 此方案解决的问题(2 分钟)
- 简要概览(3 分钟)
- 现场演示(15-20 分钟)
- 深入了解实现原理(可选,5-10 分钟)
- 问答(5-10 分钟)
成功关键:
- 始终准备备用方案(截图、视频)
- 使用真实但安全的数据
- 操作时同步讲解
- 准备好故障时的回滚方案
类型 3:知识分享 / 午餐分享
目的: 教授实用知识。
结构:
- 此主题为何重要(3 分钟)
- 核心概念(10 分钟)
- 实际应用(10 分钟)
- 易踩的坑和技巧(5 分钟)
- 资源和问答(5 分钟)
成功关键:
- 了解受众的水平
- 提供可执行的收获
- 提供后续学习资源
- 让活动具有互动性
类型 4:决策提案
目的: 为提案争取支持。
结构:
- 问题 / 机遇(3 分钟)
- 我们考虑过的选项(5 分钟)
- 我们的建议(10 分钟)
- 相较于其他方案的优势(5 分钟)
- 风险缓解措施(3 分钟)
- 请求做出决策 / 确定后续步骤(2 分钟)
成功关键:
- 开门见山地提出建议(不要把它藏在后面)
- 预判异议
- 准备数据支持论点
- 明确说明你的诉求
幻灯片设计原则
规则
- 每张幻灯片只讲一个观点 - 如果标题里需要用“和”,就拆开
- 每条项目符号 5-7 个词 - 幻灯片是提示,不是讲稿
- 视觉优先于文字 - 使用图表、截图、代码
- 设计保持一致 - 使用相同的字体、颜色和版式
- 坐在后排也能看清 - 正文至少使用 24pt
有效做法
| 元素 | 好 | 不好 |
|---|---|---|
| 标题 | 以行动为导向,具体明确 | 泛泛而谈,含糊不清 |
| 项目符号 | 关键词和短语 | 完整句子 |
| 图表 | 简洁明了,带有标注 | 信息繁杂,标注太小 |
| 代码 | 突出显示关键行 | 展示完整文件 |
| 数据 | 一个明确的要点 | 多张图表 |
幻灯片类型
标题页: 主题、姓名、日期、背景信息
议程页: 谨慎使用,放在开场引入之后
内容页: 一个观点及其支撑内容
图表页: 以视觉内容为主,文字尽量少
代码页: 语法高亮,标出关键行
总结页: 3 个关键要点
问答页: 邀请观众提问
现场演示最佳实践
准备工作
- 演示当天早上测试所有内容
- 准备好截图或视频作为备用
- 使用真实但安全的数据
- 增大字体(终端至少使用 18pt)
- 关闭通知
- 提前打开并整理好浏览器标签页和窗口
- 制定故障应对方案
执行过程
- 讲解你正在做什么
- 停顿片刻,让观众跟上
- 指出应该关注的内容
- 出现问题时坦然面对
- 准备好“脱困”方案
出现故障时
- 简短说明情况
- 尝试快速修复一次(最多 30 秒)
- 如果仍未修复,切换到备用方案
- 自信地继续
- 不要过度道歉
应对问答
技巧
重复问题: 确保所有人都听清,也给自己留出思考时间。
必要时澄清: “你问的是 X 还是 Y?”
肯定好问题: “这个观点很不错……”
不知道也没关系: “这个问题我目前没有答案,但我可以去查一下。”
必要时延后讨论: “这是个更大的话题,我们可以会后讨论。”
关联到自己的观点: “这和刚才提到的观点有关……”
棘手问题
| 类型 | 回应 |
|---|---|
| 质疑你的做法 | “这个担忧很合理。我们是这样考虑的……” |
| 超出讨论范围 | “问得好——这不在我们讨论的范围内。我们可以会后再聊。” |
| 语气充满敌意 | 保持冷静,回应问题内容,而不是语气 |
| 炫耀型提问 | “这个观点很有意思。我来谈谈实际方面……” |
| 没有明确问题的冗长发言 | “我确认一下自己是否理解了你的问题……” |
时间安排与节奏
时间分配
| 时长 | 内容 | 问答 |
|---|---|---|
| 5-10 分钟(闪电演讲) | 8 分钟 | 不安排或 2 分钟 |
| 20-30 分钟(标准) | 20-25 分钟 | 5-10 分钟 |
| 45-60 分钟(深入讲解) | 35-45 分钟 | 10-15 分钟 |
节奏建议
- 开场有力(不要浪费开场时间)
- 调整演讲状态(避免语调单一)
- 层层递进,引出关键观点
- 有策略地运用沉默
- 准时结束(或提前结束!)
练习流程
- 通读: 为自己朗读幻灯片并计时
- 口述: 不看幻灯片练习讲解
- 完整演练: 向他人演讲或录下自己的演讲
- 果断删减: 如果超时,就删掉部分内容
参考资料
如需详细指导,请参阅:
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