Skill 与 MCP：让 Agent 变强的两种方式

01Skill 和 MCP 的区别

一句话区分： Skill 是「操作说明书」，改变模型的行为方式； MCP 是「新接口」，给模型提供原本没有的能力。

两种能力的本质差异

打个比方

02哪些做 Skill，哪些做 MCP

决策表：拿到需求先过这四个问题

实战案例对照

03一个极简 Skill 示例（可落地）

一个 Skill 就是一个目录，核心文件是 SKILL.md（YAML frontmatter + Markdown 正文）。 以「部署前必须备份」为例——这个 Skill 的价值是让模型每次都记得先备份， 而不是偶尔记得：

---
name: backup-before-deploy
version: 1.0.0
description: "部署前必须备份。当用户要对线上站点/nginx 配置做任何修改、覆盖、回滚、升级时使用。不负责执行部署本身。"
metadata:
  requires:
    bins: ["ssh"]
---

# 部署前备份（强制）

**触发条件**：模型检测到用户要对线上资源做写操作（覆盖文件、改 nginx 配置、
重启服务、升级版本）时，无论用户是否主动要求，都必须先走本 Skill。

## 步骤

1. 确认目标路径属于可备份范围（站点目录 / nginx conf.d / 数据库文件）。
2. 执行备份，命名带时间戳：
   ssh chengdu "cp -a /var/www/zhugdamo_cn/site /root/backups/site-$(date +%Y%m%d_%H%M%S)"
3. 校验备份确实生成（ls 确认存在、体积合理），备份失败立即中止部署。
4. 向用户报告备份路径，再继续部署。

## 禁忌

- 绝不在没有备份的情况下覆盖线上文件。
- 备份失败 ≠ 继续部署，必须停下。

## 验证

部署完成后，把新文件与备份 diff 一遍，确认改动符合预期。

关键点

04常见 Skill 代码分析

下面拆解的是生产级 Skill 的完整结构（取自本机技能库中真实在用的 lark-approval 等技能，它们服务日常飞书审批等真实任务）。

4.1 frontmatter：给调度器看的元数据

---
name: lark-approval
version: 1.2.0
description: "飞书审批：查询和处理审批待办/已办/实例……当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。"
metadata:
  requires:
    bins: ["lark-cli"]
  cliHelp: "lark-cli approval --help"
---

4.2 正文：路由规则放最前

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，
其中包含认证、权限处理**

所有命令默认 `--as user`（审批是人的动作）。调用前先按需读取 references 下对应的文件，
查参数结构，不要猜字段；**references 是第一信息源**……

## 路由优先级（先判断是不是审批，再选命令）

审批待办不是飞书任务。**只要用户的核心对象是审批单据 / 审批待办 / 审批实例，
就优先使用 `lark-approval`，不要让渡给 `lark-task`。**

### 明确归 `lark-approval` 的高优先级语义
- 审批待办 / 审批单据 / 审批实例 / 审批意见 / 审批定义
- 同意 / 拒绝 / 转交 / 退回 / 撤回 / 催办 / 加签 / 抄送
……

**判定规则：** 只要最终动作是对审批单据做同意、拒绝、转交……就归 `lark-approval`。
只有当用户处理的是**非审批类任务/待办**时，才走 [`lark-task`](../lark-task/SKILL.md)。

4.3 生产级 Skill 的共性结构

4.4 Skill 还能带什么

my-skill/
├── SKILL.md          # 主文档：触发条件 + 步骤 + 禁忌 + 验证
├── references/       # 参数表、API 文档、完整命令清单（按需读取）
├── templates/        # 可直接套用的模板（报告、prompt、配置文件）
└── scripts/          # 可执行脚本（skill 可调用，如验证脚本、转换器）

05Skill 写作的三个常见坑