一. 什么是 Skills

Rules 声明必须遵守的约定，但是具体如何做 （先跑什么命令、如何判断结果、失败后如何处理等）全靠 Agent 临场发挥。临场发挥的问题是：命令拼错、步骤遗漏、判断逻辑每次都不一致，Skill 的出现便是为了搭配 Rules 并解决这些问题。

Skills（标准操作） 是指将步骤固定、重复场景、做错一次就会很痛苦的操作封装成 SOP（标准操作规范），让 Agent 执行时不需要去 ”想“，只需要按照 SOP 的规范去 ”做“ 即可。

Skills 以.md 文件形式存在，本质上就是 Markdown 文件，可以把 Skills 理解为”技能包“，里面通常会写一套针对特定任务的提示词和工作流程。当项目中存在 Skills 时，Agent 会自动读取内容，并根据业务场景匹配适合的 Skill。




当 Skill 被 注入 Agent 时，相当于将”技能包“赋予给了这个 Agent ，这时 Agent 就会从通用的 AI 助手变成某个领域的专业助手

1. Skills 的关键特点

• Skills 可以被重复使用，无需每次创建
• 可以把别人的 Skills 拿到自己的项目中，效果相同
• Skills 与 Rules 一样，都会被自动触发，并根据不同场景触发不同的 Skill

2. Skills 作用域

Agent 文件的存放位置决定了它的作用域，通常分为两个层级

• 项目级作用域（推荐）：存放在当前项目根目录下的 ./cursor/Skills/（或对应工具的 .opencode/Skills/）目录中。

  • 特点：仅在当前项目生效，适合与项目强相关技能，如当前项目专用的代码规范、部署流程等

• 用户级作用域：存放在用户的全局配置目录下。

  • 特点：当前用户下的所有项目都可以用，适合通用技能，比如写文档，PPT等与具体项目无关的技能。

二. 创建第一个 Skill

1. Skills 结构目录

Skill 通常是一个独立的文件夹，包含指令、脚本和资源。其核心是一个 SKILL.md 文件，典型结构如下：

skill-name/
├── SKILL.md          # 必选：核心指令文件（包含元数据和执行流程）
├── scripts/          # 可选：可执行代码脚本（如数据处理、编译脚本）
├── references/       # 可选：参考文档（如 API 文档、业务规范）
└── assets/           # 可选：资源素材（如输出模板、图片等）

• 其中，SKILL.md 通常由两部分组成：

  • YAML 元数据（头部）：

    • name（唯一标识）：当前的技能名称，如果通过命令去调用的话就是用的 name
    • description（触发路由判断）：系统通过读取 description 来决定何时激活当前技能。

  • Markdown 正文：包含任务目标、分步执行流程（Workflow）、输出规范和约束条件。

    • 总结：正文中的内容就是你希望 Agent 如何执行的具体内容

• SKILL.md 代码示例

  ---
  name: phone-test 
  description: 此技能用于辅助编写手机端自动化测试用例。 # 
  ---
  
  # 手机端自动化测试技能
  
  ## 概述
  
  此技能为手机自动化测试平台的手机端测试脚本开发提供专业指导。涵盖测试用例编写规范、框架 API 使用方法、项目结构说明及常见模式参考。
  
  ## references 目录说明
  
  **重要**：本技能将详细内容拆分到 `references/` 目录下的文件中，AI 应在需要时主动读取对应文件：
  
  | 请求场景 | 应读取的文件 |
  |----------|--------------|
  | 查 API 方法 | `references/phone_api_reference.md` |
  | UI 调试/元素定位 | `references/debug_tips.md` |
  | 操作联系人/通话记录 | `references/content_provider.md` |
  | 写测试用例模板 | `references/code_templates.md` |
  | @case 完整参数/新增方法模板 | `references/advanced_reference.md` |
  | 不确定读哪个文件 | `references/index.md` |
  
  ## 核心规则（必读）
  
  > **编码规范 & 自验证流程（已合并为单一文件）**：[rules/tatf-phone-coding-rules.mdc](tatf-phone-coding-rules.mdc)
  

2. 创建 Skills 技能

• 创建第一个技能，与 Rule 同理，也可以拿别人现成的（狗头）Agent 助手会自己扫描并注入

  • 和 Agent 对话，让它给我的项目中添加一个角色技能
    

  • Agent 生成对应的 Skills 目录
    

  • Agent 生成 Skills 示例
    

  • 校验 Skills 是否生效

    • 
    • 结果满足预期
    •