依据已读取的官方网页：Skills 文档确认 Cascade 原生 Skills、目录、frontmatter 与调用方式；官方产品页称 Devin Desktop 是 Windsurf 新名称。未确认精确版本门槛或所有新旧客户端迁移差异；下载包、作者、许可和第三方依赖须逐条检查。官方入门页要求账号登录。未实际安装、登录、运行或验证；未提供未经官方正文支持的安装命令或配置清理路径。
Preparation
- 从 Windsurf 官方下载页获取客户端；该页现以 Devin Desktop 为新名称，列出 macOS、Windows 10 64 位及满足所列 glibc/glibcxx 要求的 Linux 版本。实际安装前请核对当前系统要求。
- 官方入门文档说明使用 Devin Desktop 需要 Devin 账号登录；本教程不代为登录，也不填写或索取密码、密钥。
- 准备一个可安全检查的 Skill ZIP/目录；先核对本站条目所列作者、许可和脚本，确认允许使用/分发后再采用。不要只提取 SKILL.md，保留完整配套文件。
Installation & use
- 01
准备客户端与练习项目
从官方页面了解当前客户端名称与系统要求。选一个无真实客户资料的空项目；首次启动/使用按官方提示登录，本文未进行登录或安装。
Evidence & sourcesSKILL.md + resourcesVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 02
安全获取 Skill
在 Skills-SI 对应条目页查看作者、许可、来源与完整包信息；许可/来源不明或脚本用途不清就暂停，不运行脚本、不关闭防护。仅从本站实际提供的 HTTPS 下载入口获取；本教程未核验具体条目包。
Evidence & sourcesSKILL.md + resourcesVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 03
解压并保留完整目录
解压到临时检查位置，确认技能目录内有 SKILL.md 及其附带资源/子目录；不要只复制单个说明文件。先阅读 frontmatter、正文及其引用文件，留意外部工具或服务依赖。
Evidence & sourcesSKILL.md + resourcesVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 04
按官方目录安装
官方支持手动目录：项目级放在当前项目的 .windsurf/skills/<skill-name>/；全局放在 ~/.codeium/windsurf/skills/<skill-name>/。将完整技能目录放入对应位置，勿把 MCP 配置或 Rules 当作 Skill 安装。
.windsurf/skills/<skill-name>/SKILL.md；~/.codeium/windsurf/skills/<skill-name>/SKILL.mdEvidence & sources.windsurf/skills/<skill-name>/SKILL.md；~/.codeium/windsurf/skills/<skill-name>/SKILL.mdVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 05
调用并做首次练习
在 Cascade 输入 @技能名 显式调用，或提交符合其 description 的任务让 Cascade 判断是否自动调用。练习：用完全虚构的会议记录整理负责人、行动项和期限；不要输入真实或敏感资料。
Evidence & sourcesSKILL.md + resourcesVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 06
验证输出与技能生效
检查输出是否遵循 SKILL.md 的要求，并确认所需配套资源/格式确实被使用；不符合时显式 @技能名 重试，并检查目录、frontmatter 的 name/description 与文件完整性。官方文档描述调用方式，但本轮未实机验证。
Evidence & sourcesSKILL.md + resourcesVerify it worksWorkflow/folder illustration, not an official interface screenshot. - 07
移除技能或卸载客户端
移除单个技能时，删除本次放入的项目级或全局技能目录；项目级目录只影响该项目。卸载客户端前先关闭应用，再按系统应用管理方式卸载；官方另有配置清理说明，因本次读取文本未呈现其具体配置路径，不在此猜写。
.windsurf/skills/<skill-name>/；~/.codeium/windsurf/skills/<skill-name>/Evidence & sources.windsurf/skills/<skill-name>/；~/.codeium/windsurf/skills/<skill-name>/Verify it worksWorkflow/folder illustration, not an official interface screenshot.
Exercise & acceptance
用虚构会议记录调用一个行动清单类 Skill，生成行动项、负责人和期限，并按原文核对。
- 确认当前打开的是预期项目，并检查官方支持目录中存在完整技能子目录及 SKILL.md。
- 在 Cascade 用 @技能名 显式调用；对照技能要求核查输出与配套资源使用情况。
- 另以匹配 description 的虚构任务观察自动调用结果；不把MCP连接成功或规则生效误判为Skill已验证。
Disable & uninstall
- 关闭客户端。
- 仅移除已安装的技能目录：项目级 .windsurf/skills/<skill-name>/ 或全局 ~/.codeium/windsurf/skills/<skill-name>/。
- 如需卸载客户端，按所用操作系统的应用卸载流程操作；如需清除客户端配置，先查阅官方对应系统说明，不要猜删配置路径。
Troubleshooting
Cascade 找不到或未自动使用技能。
核对完整目录是否位于官方支持的项目级/全局路径，且其中有 SKILL.md；检查 name 与 description，先尝试 @技能名 显式调用。
显式调用名称不匹配或技能内容不合预期。
核对 SKILL.md frontmatter 中的 name，并确认技能名与 @提及一致；检查正文和引用资源是否完整、可读。
复制后缺少模板、参考资料或脚本。
重新解压原始完整包并保留技能目录的所有配套文件；按说明单独核验外部依赖，未经检查不要运行脚本。
误把 Workflow、Rule 或 MCP 配置当作 Skill。
按官方定义区分：Skill 是含 SKILL.md、可带配套文件的技能目录；Rules 与 Workflows 是不同定制功能；MCP 扩展代理能力，不等同 Skill。
Evidence & sources
- https://docs.windsurf.com/windsurf/cascade/skills
官方 Cascade Skills 正文：技能目录、项目级/全局路径、SKILL.md frontmatter、配套文件、自动与 @ 显式调用；并区分 Skills、Rules 与 Workflows。
- https://windsurf.com/download
官方产品下载页：Devin Desktop 是 Windsurf 的新名称；列出下载选项及 macOS、Windows、Linux最低要求。
- https://docs.windsurf.com/windsurf/getting-started
官方入门页：账号登录要求、启动 agent session 的方式及卸载的一般说明。