你有没有算过，自己在 AI 对话框里打过的那些「开场白」，加起来有多长？

「这个目录里的文件按项目分文件夹、按年月归档，重名加日期后缀，最后给我一份清单……」「表格里的空行要删掉，表头统一成这七个字段，日期格式换成 YYYY-MM-DD……」「写周报的时候口径按上季度那套算法，别自己发挥……」

这些话术高度重复，每次都得完整说一遍，少说一句结果就跑偏。问题不在于模型不够聪明，而在于——**你每次都在让一个新人重新入职，却指望他第一天就熟悉全部流程**。

真正的解法不是把提示词写得更长，而是把「交代」这件事本身，从「每次口头讲」升级为「一次性写成制度」。在 WorkBuddy 里，这套制度就叫 **Skill（技能）**。

## 一、先纠正一个认知：Skill 不是「提示词模板」

很多人第一次接触技能，会把它理解成「一段存起来的提示词」。这个理解会导致一个典型后果：造出来的技能时灵时不灵，或者干脆不触发。

差别在哪？提示词模板是**给人复制粘贴的文本**；而技能是**给 Agent 读的能力说明书**。前者只需要你懂，后者需要机器能判断「现在该不该用它」。

这个差别决定了两件事：

1. **它必须有明确的触发边界**。Agent 要先判断「当前这个任务属于我的职责范围吗」，才谈得上执行。触发词写得含糊，它就会在该上场时沉默、在不该上场时抢戏。
2. **它必须自带资源，而不是自带背景介绍**。你不需要在技能里反复解释「什么是归档」，你需要的是把字段定义、命名规则、判断标准这些**可执行的约束**放进去。

理解了这一点，后面的步骤就顺了。

## 二、六步，造一个能被自动触发的技能

### 第 1 步：先回答三个问题，别急着写文件

动笔前把这三行写下来，写在纸上都行：

| 问题 | 反例 | 正例 |
| --- | --- | --- |
| 它解决哪一个具体问题？ | 帮我处理文件 | 把散落在下载目录的素材按项目归档 |
| 用户会怎么喊它？（2–3 个词） | 整理、处理、弄一下 | 素材归档、文件归档 |
| 输出长什么样？ | 整理好的文件 | 归档目录树 + 一份 Markdown 清单 |

反例的问题一眼能看出：范围太宽。**触发词越泛，越容易和内置能力撞车**，最后变成一个永远不被调用的技能。

### 第 2 步：建一个目录

技能就是「一个文件夹 + 一个 SKILL.md」，位置在用户级技能目录下：

```bash
# 目录名用英文，短、可读、不带空格
mkdir -p ~/.workbuddy/skills/archive-keeper
cd ~/.workbuddy/skills/archive-keeper
touch SKILL.md
```

### 第 3 步：写 SKILL.md —— 这是全部的核心

一份能用的 SKILL.md 由两部分组成：顶部的 YAML 前言（frontmatter）负责**让系统认识它**，下方的 Markdown 正文负责**让 Agent 会用它**。

```yaml
---
name: archive-keeper
description: 素材归档助手。把散落在同一目录下的文件按项目与年月归档，重名自动加后缀，并输出归档清单。
author: 你的名字
version: 1.0.0
tags:
  - file
  - organize
---
```

前言里最关键的是 `description`：**它不是给人看的简介，而是 Agent 判断「要不要用你」的唯一依据**。所以描述里要出现「做什么 + 什么场景 + 产出什么」，而不是一句「一个很好用的技能」。

正文部分建议固定成四段，顺序别乱：

```markdown
## 角色定义
你是素材归档助手，只负责文件归类与清单生成，不修改文件内容。

## 工作流程
1. 扫描目标目录，列出所有待归档文件及其扩展名。
2. 按扩展名映射到分类：图片 / 文档 / 表格 / 压缩包 / 其他。
3. 在目标目录下创建 `归档/YYYY-MM/分类/` 三级结构。
4. 逐个移动文件；若目标已存在同名文件，追加 `-01`、`-02` 后缀。
5. 生成 `归档清单.md`，含原路径、新路径、文件大小。

## 输出规范
- 全程使用相对路径展示，不打印绝对路径。
- 清单按分类分组，同类按文件名排序。
- 结束时回报：移动 N 个文件，跳过 M 个。

## 边界约束
- 不删除任何文件，冲突一律改名而非覆盖。
- 遇到不认识的扩展名，归入「其他」并单独提示。
- 超出上述范围的需求（如重命名内容、修改表格数据），明确拒绝并说明原因。
```

注意最后一段「边界约束」。**这一段的实际价值远高于前几段**——它是防止技能在意外输入下乱跑的安全带。

### 第 4 步：把大块材料挪出 SKILL.md

一个常见误区是把所有规则、所有示例、所有术语表全塞进 SKILL.md。后果是每次触发技能都要拖着这一大坨内容进上下文，既慢又贵。

正确做法是**分层**：SKILL.md 只放「必须每次都知道的规则」，大块资料放同目录的参考文件里，正文里写一句「需要时读取」：

```
archive-keeper/
├── SKILL.md              # 只放流程与约束，保持精简
└── references/
    ├── extensions.md     # 扩展名 → 分类的完整映射表
    └── naming.md         # 命名规则的完整示例
```

SKILL.md 里对应写：

```markdown
## 参考资源
- 扩展名映射表：references/extensions.md（执行第 2 步时读取）
- 命名规则示例：references/naming.md（执行第 4 步时读取）
```

**只在需要时读取，而不是一次性全加载**，这是让技能「跑得久还不臃肿」的关键。

### 第 5 步：三轮测试，别只跑一遍就上生产

| 轮次 | 做什么 | 要验证什么 |
| --- | --- | --- |
| 第 1 轮 | 用真实目录跑一次完整流程 | 输出是否符合「输出规范」里写的每一条 |
| 第 2 轮 | 换一个完全不同的目录再跑 | 换环境后风格与结构是否稳定 |
| 第 3 轮 | 故意喂边界输入 | 超范围时是否按「边界约束」拒绝，而不是硬着头皮瞎做 |

第 3 轮最容易被跳过，也最容易暴露问题。比如往技能里丢一个「顺便把内容也改了吧」的要求，看它是乖乖拒绝，还是开始自作主张。

### 第 6 步：固化与分发

自己用，放在 `~/.workbuddy/skills/` 下就生效了。要给同事用，把整个文件夹打包发过去即可：

```bash
# 在技能目录的上一级执行，打包整个文件夹
cd ~/.workbuddy/skills
zip -r archive-keeper.zip archive-keeper/
```

想公开分享，则需要补全前言字段、配好图标，提交到技能市场等待安全扫描——扫描会按风险等级分级，高风险会被直接拒绝。

## 三、完整场景：这个技能到底省了什么

假设你是做内容运营的，每次活动结束，下载目录里会堆上几十个文件：图片、文档、压缩包混在一起，文件名毫无规律。

**造技能之前**，你的操作是：打开对话框 → 打一段两百字的交代 → 等 AI 处理 → 发现它把「最终版」和「最终版-改」归到了不同分类 → 再补一句修正 → 重来。

**造技能之后**，你的操作是：一句话。

```
@archive-keeper 把 ~/Downloads/campaign-09 归档一下
```

它按 SKILL.md 的流程执行：扫描 47 个文件 → 建 `归档/2026-09/图片|文档|表格|压缩包|其他` 结构 → 移动文件、冲突自动加后缀 → 生成清单，回报「移动 47 个，跳过 0 个，其中 3 个扩展名未识别已归入其他」。

这就是那套「制度」的价值：**同一套标准，第一次和第一万次执行的结果完全一致，而你需要付出的只是第一天的十分钟**。

## 四、三个最容易踩的坑

**坑一：触发词太泛。** 「整理」「处理」「优化」这类词几乎会出现在所有任务里，导致技能频繁误触发或被系统内置能力压过去。解决办法是加限定词：把「整理」改成「素材归档」「文件归档」。

**坑二：SKILL.md 越写越长。** 见到问题就往 SKILL.md 里补一句规则，几个月后它变成一篇三千字的长文，每次触发都拖着走。正确的动作是**判断这条规则是「每次都需要的约束」还是「特定情况的资料」**——前者留在 SKILL.md，后者挪进 references。

**坑三：只测 happy path。** 顺利路径跑通不等于技能可用。真正决定它能不能长期待在技能库里的，是它在输入超范围时有没有体面地拒绝。

## 五、什么时候该造技能，什么时候不该

不是所有重复劳动都值得封装。一个简单的判断标准：**看你要不要「重复交代」**。

- 如果一件事你做过三次以上，且每次都要重新说一遍前提条件 → 值得造技能。
- 如果一件事只做一次，或者每次的判断标准都不一样 → 不值得，直接用一次性对话更划算。
- 如果一件事需要跨多个工具、多个步骤，且有固定的正确顺序 → 最值得，这正是技能最擅长的形态。

技能库不是越多越好，它更像是你的私人工具柜：**每个格子里放的都是真正高频、真正顺手的那几件**。塞满用不上的东西，只会让你下次找工具时更慢。

所以不妨现在就回头翻一翻自己的对话记录：哪一段开场白，你已经打过三遍以上了？把它挑出来，按上面的六步写成第一个技能——大概用不了十分钟，但往后每一次调用，都是在替你省下那十分钟。


「这个目录里的文件按项目分文件夹、按年月归档，重名加日期后缀，最后给我一份清单……」「表格里的空行要删掉，表头统一成这七个字段，日期格式换成 YYYY-MM-DD……」「写周报的时候口径按上季度那套算法，别自己发挥……」

WorkBuddy × 自定义技能实战：把「每次都要交代一遍」的活儿，变成一句话触发

人工智能

开发工具

职业发展

把重复的AI开场白变成可自动触发的Skill技能，六步构建：定义问题、建目录、写精简SKILL.md、拆分参考资料、三轮测试、固化分发。核心是触发词精准、规则清晰、边界明确，避免提示词模板陷阱，一次封装，永久复用。

代码解释

WorkBuddy 

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

WorkBuddy × 自定义技能实战：把「每次都要交代一遍」的活儿，变成一句话触发-腾讯云开发者社区-腾讯云

WorkBuddy × 自定义技能实战：把「每次都要交代一遍」的活儿，变成一句话触发

WorkBuddy × 自定义技能实战：把「每次都要交代一遍」的活儿，变成一句话触发

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐