# Agent Skill 入门指南

让 AI 助手学会新技能

Speaker · 2025

## 核心价值

### 可复用

把成熟做法沉淀成固定能力，后续场景直接复用。

### 自动触发

写清描述与触发词后，模型会在合适时机主动调用。

### 组件化

规则、模板、脚本与示例可以拆分维护、按需组合。

### 社区共享

团队经验不再只留在聊天里，而能被持续传播与协作。

## 什么是 Agent Skill？

### 一句话定义

Skill 是给 AI 助手写的操作手册

- 告诉助手什么时候该出手
- 规定步骤、边界与输出格式
- 把经验从“会做”变成“稳定复现”

    ---
    name: demo-skill
    description: 当用户要生成日报时触发
    ---

    ## Steps
    1. 收集输入
    2. 套用模板
    3. 输出结果

## Skill vs 传统方式

### 传统方式

- 每次重写 Prompt
- 需要编码 Plugin
- 静态配置文件
- 无法跨项目复用

### Agent Skill

- 纯 Markdown 编写
- 自动场景匹配
- 上下文感知
- Git 版本管理

## Skill 文件结构

- SKILL.md 是唯一必需文件
- Frontmatter 定义触发条件
- 正文描述操作流程
- 可附带脚本和模板

    # my-skill
    - SKILL.md
    - templates/
      - report-template.md
    - scripts/
      - validate.py
    - examples/
      - demo-input.json

## 创建流程

1

#### 确定场景

明确 Skill 要解决的具体问题和使用场景

2

#### 编写 SKILL.md

定义触发词、工作流工具调用与输出格式

3

#### 测试验证

多场景触发测试优化描述与输出质量

4

#### 发布共享

推送到 GitHub 仓库供团队或社区安装使用

## Skill 生态增长

## Skill 使用场景分布

## 最佳实践速查

写 Skill 前，先用这张表做一次快速自检。

维度 | ✅ 推荐做法 | ❌ 避免做法
--- | --- | ---
命名 | 动词短语，如“生成周报” | 只写名词，如“周报”
Description | 写清触发条件与上下文 | 只写笼统功能名
篇幅 | 聚焦核心步骤，控制在 <500 词 | 把所有内容都塞进一个文件
测试 | 先看无 Skill 表现，再比较增益 | 直接部署，不做基线验证

## 开始创建你的 Skill

— · —