vibecoding起步之Claude Code的skills是什么，里面有什么文件，以ppt的一个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 依赖这些脚本的固定接口来工作。

二、技能定义与能力说明文件

1. `SKILL.md`（最核心的文件）

功能定位：技能的"身份证"和"使用说明书"，是 Claude 了解这个技能能做什么、不能做什么的唯一入口。

核心内容：

技能名称与描述：告诉 Claude 这是一个"PPTX 生成与编辑技能"
能力清单：明确列出支持的所有操作（如：生成多页 PPT、插入图表、使用模板、导出为 PDF 等）
限制说明：明确列出不支持的操作（如：不支持复杂动画、不支持 SmartArt 图形等）
使用示例：给 Claude 提供自然语言指令的示例（如："帮我生成一个关于 AI 大模型的 5 页 PPT"）
调用方式 ：告诉 Claude 如何调用 scripts/ 目录下的脚本，以及参数格式

用户可自定义：你可以修改这个文件，添加你希望 Claude 支持的 PPT 风格、模板或特殊格式要求。

2. `pptxgenjs.md`

功能定位 ：Claude 的"API 参考手册"，是 pptxgenjs 库的完整文档副本。

作用：

当 Claude 需要编写或修改 PPT 生成逻辑时，会查阅这个文档
包含所有可用的 API 方法、参数说明和代码示例
确保 Claude 生成的代码符合 pptxgenjs 的规范，不会出现语法错误

为什么是 .md 格式：因为 Claude 最擅长理解 Markdown 格式的文档，比直接看 JS 源码效率高得多。

3. `editing.md`

功能定位：PPT 编辑操作的"最佳实践指南"。

核心内容：

告诉 Claude 如何安全地编辑现有 PPT 文件
列出常见的编辑场景和对应的正确操作步骤
包含避免破坏 PPT 格式的注意事项
提供批量修改的示例（如：统一修改所有幻灯片的字体、颜色）

三、配置文件

1. `settings.json`（全局默认配置）

功能定位：技能的全局默认配置文件，适用于所有使用这个技能的项目。

典型配置项：

json 复制代码

{
  "defaultTheme": "modern", // 默认主题
  "defaultFont": "Microsoft YaHei", // 默认字体
  "defaultSlideSize": "16:9", // 默认幻灯片尺寸
  "maxSlides": 50, // 单次生成的最大幻灯片数量
  "enableCharts": true, // 是否启用图表支持
  "enableImages": true, // 是否启用图片插入支持
  "outputDirectory": "./output" // PPT 文件输出目录
}

2. `settings.local.json`（本地覆盖配置）

功能定位 ：个人/项目专属配置文件 ，会覆盖 settings.json 中的默认配置。

关键特性：

这个文件不会被提交到版本控制（通常在 .gitignore 中）
用于存储个人偏好或项目特定的配置
可以在这里设置你常用的公司模板、字体、配色方案等

示例：

json 复制代码

{
  "defaultFont": "PingFang SC",
  "templatePath": "./templates/company-template.pptx",
  "outputDirectory": "./presentations"
}

四、其他文件

`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 模板，包含常用的中文配置和公司模板设置吗？

vibecoding起步之Claude Code的skills是什么，里面有什么文件，以ppt的一个skills举例

Claude Code PPTX 技能包完整文件功能详解

一、核心执行层：scripts/ 目录

二、技能定义与能力说明文件

1. SKILL.md（最核心的文件）

2. pptxgenjs.md

3. editing.md