最棘手的工程任务往往不只是写几个好的提示这么简单。它们可能还需要参考脚本、模板、检查列表以及其他辅助文件。技能让你可以把所有这些内容打包成文件夹，供 Cascade 调用 (读取和使用) 。
技能是教会 Cascade 如何稳定、可靠地执行多步工作流的绝佳方式。
Cascade 使用 渐进式披露 (progressive disclosure) 机制：默认情况下，只有技能的 name 和 description 会显示给 AI 模型。完整的 SKILL.md 内容和辅助文件仅在 Cascade 决定调用该技能时 (或当你 @mention 它时) 才会被加载。即使定义了许多技能，这也能让你的上下文窗口保持精简。
有关 Skills 规范的更多详细信息，请访问 agentskills.io。
- 打开 Cascade 面板
- 点击面板右上角的三个点以打开 Customizations 菜单
- 点击
Skills 部分
- 点击
+ Workspace 以创建工作区（针对特定项目的）技能，或点击 + Global 以创建全局技能
- 为该技能命名（仅使用小写字母、数字和连字符）
工作区 Skill（针对特定项目）：
- 创建目录：
.windsurf/skills/<skill-name>/
- 添加带有 YAML 头部信息的
SKILL.md 文件
全局 Skill（在所有工作区可用）：
- 创建目录：
~/.codeium/windsurf/skills/<skill-name>/
- 添加带有 YAML 头部信息的
SKILL.md 文件
每个 skill 都需要一个 SKILL.md 文件，其 YAML frontmatter 中包含该 skill 的元数据：
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---
## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables
## Deployment Steps
Follow these steps to deploy safely...
[Reference supporting files in this directory as needed]
- name：技能的唯一标识符（会显示在 UI 中，并用于 @ 提及）
- description：提供给 AI 模型的简要说明，帮助其判断在何时调用该技能
有效名称示例：deploy-to-staging、code-review、setup-dev-environment
将任何辅助文件放在技能文件夹中，与 SKILL.md 放在一起。这些文件会在调用该技能时供 Cascade 访问：
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
description 字段至关重要：它帮助 Cascade 理解在何时应调用该 skill。请撰写能够清晰说明该 skill 的作用，以及在什么情况下应该使用它的描述。
你可以随时在 Cascade 的输入框中输入 @skill-name 来显式激活某个 skill。当你想确保使用某个特定的 skill，或者想调用一个可能不会因你的请求而自动触发的 skill 时，这会非常有用。
| 作用域 | 位置 | 可用范围 |
|---|
| 工作区 | .windsurf/skills/ | 仅当前工作区。随代码仓库一同提交。 |
| 全局 | ~/.codeium/windsurf/skills/ | 当前机器上的所有工作区。不随代码仓库提交。 |
| 系统 (Enterprise) | 特定于操作系统 (见下文) | 所有工作区，由 IT 部署。只读。 |
为实现跨代理兼容性，Windsurf 也会在 .agents/skills/ 和 ~/.agents/skills/ 中发现技能。如果你已启用 Claude Code 配置读取，.claude/skills/ 和 ~/.claude/skills/ 也会被扫描。
| OS | Path |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md 文件，与工作区技能相同。
创建一个包含部署脚本、环境配置和回滚方案的 Skill：
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
-
编写清晰的描述：描述有助于 Cascade 判断何时调用该 skill。要具体说明该 skill 的功能，以及在什么情况下应当使用它。
-
包含相关资源：模板、检查清单和示例能让 skill 更有用。思考一下哪些文件能帮助他人完成这项任务。
-
使用具有描述性的名称：
deploy-to-staging 比 deploy1 更好。名称应清楚表明该 skill 的作用。
这三者都可以用来自定义 Cascade，但它们在结构、调用方式和上下文成本上有所不同：
| 技能 | Rules | Workflows |
|---|
| 用途 | 带辅助文件的多步骤流程 | 行为准则（“如何表现”） | 用于可重复任务的提示模板 |
| 结构 | 包含 SKILL.md 和任意资源文件的文件夹 | 带 frontmatter 的单个 .md 文件 | 单个 .md 文件 |
| 调用方式 | 由模型决定（渐进式披露）或通过 @mention 调用 | always_on / glob / model_decision / manual | 仅支持手动，通过 /slash-command |
| 会出现在系统提示词中吗？ | 不会——调用前只包含名称和描述 | 取决于激活模式 | 不会——仅列为可用命令 |
| 最适合 | 需要脚本/模板的部署、代码审查、测试流程 | 编码风格、项目约定、约束条件 | 由你显式触发的一次性操作手册 |
