# Agent Skill 入门指南

让 AI 助手学会新技能

Speaker · 2025

## 核心价值

### 可复用

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

### 自动触发

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

### 组件化

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

### 社区共享

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

## 什么是 Agent Skill？

### 定义

Agent Skill 是给 AI 助手准备的可复用能力包。

- 用 Markdown 描述场景、规则与执行步骤
- 通过描述自动匹配，而不是每次重新写长 Prompt
- 可以封装模板、脚本、图表、文档读取等工作流

> 把经验写成技能，而不是留在一次次对话里。

    ---
    name: agent-skill
    description: "把经验封装成可触发能力"
    ---
    ## Triggers
    - 生成周报
    - 读取 OneNote

    ## Steps
    1. 识别场景
    2. 调用组件
    3. 输出结果

## Skill vs 传统方式

### 传统方式

- 每次重写 Prompt
- 需要编码 Plugin
- 静态配置文件

### Agent Skill

- 纯 Markdown
- 自动匹配
- 上下文感知

## Skill 文件结构

- 前置 metadata 决定名称、触发范围与能力定位
- Overview 说明用途，帮助助手快速选对技能
- Workflow 约束步骤，让输出更稳定、更可复现
- Reference 与 Checklist 保证组件复用与质量校验

    ---
    name: html-presentation
    description: "把主题与模板组装成 HTML 演示"
    ---
    ## Overview
    ## Workflow
    ## Reference Library
    ## Quality Checklist

## 创建流程

1

#### 确定场景

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

2

#### 编写 SKILL.md

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

3

#### 测试验证

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

4

#### 发布共享

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

## Skill 生态增长

## Skill 使用分布

## 最佳实践

让 Skill 更易触发、更好维护、更容易复用

维度 | ✅ 推荐 | ❌ 避免
--- | --- | ---
命名 | 短、准、可搜索，如 weekly-report | 模糊抽象，如 helper123
描述 | 明确场景、输入与触发词 | 只写“处理任务”之类空泛描述
长度 | 结构清晰，分节表达规则与步骤 | 所有要求堆成一大段长文
测试 | 用真实样例反复验证触发与输出 | 写完即发布，从不回看效果

## 开始创建你的 Skill

— · —