下载 Skill 压缩包下载一个 .zip 文件到你的电脑
点击下方按钮，将 Skill 压缩包下载到你的电脑上。记住你保存到了哪里。
下载 visual-storytelling.zip找到 Skill 目录每个 WorkBuddy 用户都有一个 Skill 文件夹
WorkBuddy 的 Skill 存放在你电脑上的固定路径中。不同操作系统路径不同：
如果这个目录还不存在，没关系——下一步会教你创建它。
open ~/.workbuddy/skillsWindows 用户：按
Win + R，输入 %USERPROFILE%\.workbuddy\skills，回车。如果提示目录不存在，先输入
mkdir %USERPROFILE%\.workbuddy\skills 创建它。
解压到 Skill 目录把文件放到正确的位置
将下载好的 visual-storytelling.zip 解压，放到 Skill 目录中。解压后的目录结构应该长这样：
visual-storytelling（全小写，用连字符），而且 SKILL.md 文件直接在这个文件夹里面，不要多套一层目录。❌ 错误：
~/.workbuddy/skills/visual-storytelling/visual-storytelling/SKILL.md✅ 正确：
~/.workbuddy/skills/visual-storytelling/SKILL.md
ls ~/.workbuddy/skills/visual-storytelling/SKILL.md如果显示文件路径，就说明放对了。如果提示「No such file」，检查一下是不是多套了一层。
验证安装是否成功确认 WorkBuddy 能识别这个 Skill
安装完成后，重启一下 WorkBuddy（如果正在使用的话）。然后：
- 打开 WorkBuddy 对话窗口
- 在左侧栏找到「Skill」或「技能」入口
- 你应该能在技能列表中看到「visual-storytelling」
或者更简单的方法——直接对 AI 说一句：
如果 AI 开始按照视觉叙事的工作流跟你对话（询问源文件、做叙事诊断等），就说明安装成功了！🎉
第一次使用体验完整的视觉叙事工作流
安装成功后，你可以这样使用：
第一步：准备素材
准备一个你想要转换的文档——PDF、PPT、Word、或者一段纯文本都可以。
第二步：启动 Skill
对 AI 说一句自然语言指令，比如：
第三步：跟着流程走
AI 会自动走完整个工作流：
- 信息提取 — 读取你的文档，提取核心内容
- 叙事诊断 — 分析内容特点，推荐最合适的叙事模式
- 方案确认 — 输出叙事方案让你确认或调整
- HTML 生成 — 生成完整的视觉叙事页面
- 部署交付 — 部署到线上，给你一个可以分享的链接
常见问题遇到问题？看看这里
Q: 安装后 AI 没有识别到 Skill 怎么办？
确认 SKILL.md 在正确路径：~/.workbuddy/skills/visual-storytelling/SKILL.md。然后重启 WorkBuddy。如果还不行，检查文件名是否全小写。
Q: 支持 Windows 吗？
支持。Skill 全部是纯文本文件（Markdown + JavaScript），没有平台限制。路径改为 C:\Users\你的用户名\.workbuddy\skills\visual-storytelling\。
Q: .workbuddy 文件夹在哪？找不到怎么办？
如果没有 .workbuddy 文件夹，说明你还没用过 WorkBuddy。先正常使用 WorkBuddy 进行一次对话，它会自动创建这个文件夹。然后再按教程操作即可。
Q: 可以用 ZIP 里的 deploy.mjs 脚本做什么？
这是一个可选的部署脚本，用于将生成的 HTML 页面部署到阿里云 OSS。如果你不需要自动部署，完全可以忽略它。AI 在生成页面后也会提供其他部署方式。
Q: Skill 更新了怎么办？
重新下载最新的 visual-storytelling.zip，解压覆盖原来的文件夹即可。CHANGELOG.md 记录了每次更新的内容。
Q: 如何卸载？
直接删除 ~/.workbuddy/skills/visual-storytelling/ 整个文件夹即可。不会留下任何残留。