第十章：vibe coding起步之Claude Code的skills是什么
Claude Code PPTX 技能包完整文件功能详解
这是 Claude Code（Anthropic 官方代码编辑器/AI Agent） 的官方 PPTX 生成技能包，是目前 Claude 生态中最成熟的 PowerPoint 自动化解决方案。所有文件严格遵循 Claude Skill 规范，各司其职，共同让 Claude 具备"用自然语言生成/编辑专业 PPT"的能力。
一、核心执行层：scripts/ 目录
功能定位：技能的"底层执行引擎"，存放所有可被 Claude 调用的自动化脚本。
•
技术栈：基于 Node.js + pptxgenjs 库（业界最流行的纯 JS PPT 生成库）
•
工作原理：Claude 理解你的 PPT 需求后，不会自己写复杂的 PPT 生成代码，而是调用这里预先写好的、经过测试的脚本，传入参数来完成任务
•
典型文件内容：
◦
generate-pptx.js：核心脚本，接收 JSON 格式的 PPT 大纲，生成完整的 .pptx 文件
◦
edit-pptx.js：编辑现有 PPT，支持修改文本、替换图片、新增幻灯片
◦
extract-content.js：从现有 PPT 中提取所有文本、图片、表格内容
◦
apply-template.js：将自定义模板应用到生成的 PPT 中
重要提示：不要手动修改这里的脚本，除非你非常清楚自己在做什么。Claude 依赖这些脚本的固定接口来工作。
二、技能定义与能力说明文件
SKILL.md（最核心的文件）
功能定位：技能的"身份证"和"使用说明书"，是 Claude 了解这个技能能做什么、不能做什么的唯一入口。
核心内容：
•
技能名称与描述：告诉 Claude 这是一个"PPTX 生成与编辑技能"
•
能力清单：明确列出支持的所有操作（如：生成多页 PPT、插入图表、使用模板、导出为 PDF 等）
•
限制说明：明确列出不支持的操作（如：不支持复杂动画、不支持 SmartArt 图形等）
•
使用示例：给 Claude 提供自然语言指令的示例（如：“帮我生成一个关于 AI 大模型的 5 页 PPT”）
•
调用方式：告诉 Claude 如何调用 scripts/ 目录下的脚本，以及参数格式
用户可自定义：你可以修改这个文件，添加你希望 Claude 支持的 PPT 风格、模板或特殊格式要求。
1.1
pptxgenjs.md
功能定位：Claude 的"API 参考手册"，是 pptxgenjs 库的完整文档副本。
作用：
•
当 Claude 需要编写或修改 PPT 生成逻辑时，会查阅这个文档
•
包含所有可用的 API 方法、参数说明和代码示例
•
确保 Claude 生成的代码符合 pptxgenjs 的规范，不会出现语法错误
为什么是 .md 格式：因为 Claude 最擅长理解 Markdown 格式的文档，比直接看 JS 源码效率高得多。
editing.md
功能定位：PPT 编辑操作的"最佳实践指南"。
核心内容：
告诉 Claude 如何安全地编辑现有 PPT 文件
列出常见的编辑场景和对应的正确操作步骤
包含避免破坏 PPT 格式的注意事项
提供批量修改的示例（如：统一修改所有幻灯片的字体、颜色）
三、配置文件
settings.json（全局默认配置）
功能定位：技能的全局默认配置文件，适用于所有使用这个技能的项目。
典型配置项：
{
"defaultTheme": "modern", // 默认主题
"defaultFont": "Microsoft YaHei", // 默认字体
"defaultSlideSize": "16:9", // 默认幻灯片尺寸
"maxSlides": 50, // 单次生成的最大幻灯片数量
"enableCharts": true, // 是否启用图表支持
"enableImages": true, // 是否启用图片插入支持
"outputDirectory": "./output" // PPT 文件输出目录
}
一键获取完整项目代码
json
1
2
3
4
5
6
7
8
9
settings.local.json（本地覆盖配置）
功能定位：个人/项目专属配置文件，会覆盖 settings.json 中的默认配置。
关键特性：
这个文件不会被提交到版本控制（通常在 .gitignore 中）
用于存储个人偏好或项目特定的配置
可以在这里设置你常用的公司模板、字体、配色方案等
示例：
{
"defaultFont": "PingFang SC",
"templatePath": "./templates/company-template.pptx",
"outputDirectory": "./presentations"
}
一键获取完整项目代码
json
1
2
3
4
5
四、其他文件
LICENSE.txt
功能定位：技能的开源许可证文件。
说明这个技能的使用权限、分发规则和版权信息
通常是 MIT 许可证，允许自由使用、修改和分发
五、完整工作流程
当你对 Claude 说"帮我生成一个关于 Q2 销售数据的 8 页 PPT"时，整个流程是这样的：
Claude 读取 SKILL.md，确认自己有生成 PPT 的能力
Claude 与你沟通，明确 PPT 的大纲、内容和风格要求
Claude 查阅 pptxgenjs.md 和 editing.md，了解具体的实现方法
Claude 读取 settings.json 和 settings.local.json，获取配置信息
Claude 调用 scripts/generate-pptx.js 脚本，传入生成好的 JSON 格式大纲
脚本执行完成，在指定目录生成 .pptx 文件
Claude 告诉你文件已生成，并询问是否需要修改
六、实用自定义技巧
添加公司模板：在 settings.local.json 中设置 templatePath 指向你的公司 PPT 模板
自定义主题：修改 settings.json 中的 defaultTheme，或添加新的主题配置
扩展能力：在 SKILL.md 中添加新的能力描述，并在 scripts/ 目录下编写对应的脚本
设置默认输出目录：在 settings.local.json 中修改 outputDirectory，让生成的 PPT 自动保存到你指定的位置
需要我给你一个可直接复制使用的 settings.local.json 模板，包含常用的中文配置和公司模板设置吗？