如何写 Skill

核心概念Skill 是一个自包含的模块用来给 Claude/Cascade 注入特定领域的知识、工作流和工具。本质上就是一个新手入职指南让通用 AI 变成某个领域的专家。目录结构skill-name/ ├── SKILL.md # 必须核心文件 └── (可选资源) ├── scripts/ # 可执行脚本 (Python/Bash) ├── references/ # 参考文档按需加载 └── assets/ # 输出用的模板/图片/字体等SKILL.md 格式--- name: my-awesome-skill description: 做什么 什么时候触发。这是唯一的触发机制必须写清楚。例如用于处理 PDF 文件的创建、编辑、合并。当用户需要操作 .pdf 文件时使用。 --- # 正文具体指令 ## 快速开始 [核心工作流简洁示例] ## 进阶功能 - **表单填充**: 详见 [references/forms.md](references/forms.md) - **API 参考**: 详见 [references/api.md](references/api.md)关键原则1. 简洁至上上下文窗口是公共资源。只写 Claude 不知道的东西不要教它写 JavaScript。SKILL.md 控制在500 行以内。2. 自由度匹配任务风险自由度适用场景形式高多种方案都行文字指引中有偏好模式伪代码/带参脚本低操作脆弱易错具体脚本少量参数3. 渐进式加载三层元数据name description— 始终在上下文中~100词SKILL.md 正文— 触发后加载5k词bundled resources— 按需读取无限制重点description是唯一触发入口什么时候用必须写在 description 里不要写在正文。4. 拆分大内容多框架/多变体的 skill正文只放核心流程和选择指引细节拆到references/下cloud-deploy/ ├── SKILL.md # 主流程 选择逻辑 └── references/ ├── aws.md ├── gcp.md └── azure.md用户选 AWS 时Claude 只读aws.md。实操步骤明确用例— 想清楚用户会怎么用收集具体例子规划资源— 哪些脚本/参考/素材需要复用初始化— 运行scripts/init_skill.py skill-name --path 目录编辑实现— 先写 scripts/references/assets再写 SKILL.md打包— 运行scripts/package_skill.py skill目录迭代— 实际使用后持续改进实际例子假设你要做一个Vue 组件生成器skill--- name: vue-component-generator description: 快速生成 Vue 2/3 组件脚手架代码。当用户要求创建新的 Vue 组件、页面模板、或表单组件时使用。支持 Element UI 和 Ant Design Vue。 --- # Vue 组件生成器 ## 工作流 1. 确认 Vue 版本2 or 3和 UI 框架 2. 根据组件类型选择模板 3. 生成组件代码 ## 组件类型 - **表格页面**: 详见 [references/table-page.md](references/table-page.md) - **表单页面**: 详见 [references/form-page.md](references/form-page.md) - **弹窗组件**: 详见 [references/dialog.md](references/dialog.md) ## 代码规范 - 使用项目现有的 ESLint/Prettier 配置 - 命名遵循 kebab-case不要做的事❌ 不要加 README.md、CHANGELOG.md 等无关文件❌ 不要在正文重复 description 里的触发条件❌ 不要写 Claude 已经知道的通用知识❌ 不要把所有内容都塞进 SKILL.md学会拆分到 references