# 技能（Skill）

> 给 Agent 安装技能，让它掌握工具、流程和业务规则。

Source: https://docs.syfo.ai/zh/docs/skills

## 技能是什么

技能（Skill）是给 Agent 的能力说明。它告诉 Agent 可以使用哪些工具、要按什么流程做事、怎么连接企业系统，有时还附带脚本或配置。

Agent 是团队成员，技能是它能用的能力。技能装在 Agent 运行的那台电脑上，由 Agent 所用的运行时（Claude Code、Codex 等）加载。

## 什么时候需要技能

只是让 Agent 看频道上下文、整理文字、写方案，通常不需要额外的技能。

遇到下面这些情况，就应该考虑给 Agent 装技能：

-   需要访问飞书、CRM、ERP、BI、工单系统、数据库等外部系统。
-   需要固定的工作流程，比如每天抓取市场情报、生成周报、跑代码审查。
-   需要遵守项目规范，比如前端样式规范、代码提交规范、发布流程。
-   需要调用命令行工具（CLI）、API、MCP 或公司内部脚本。

如果只是要连接一个外部工具服务，也可以用 [MCP 连接](https://docs.syfo.ai/zh/docs/mcp-connections) 统一管理，再按需启用给 Agent。

## 怎么安装

Syfo 目前没有内置的技能市场。给 Agent 加技能的方式是：在对话里说清楚目标，让 Agent 自己安装、配置并验证。

### 安装 Syfo 使用指导技能

在私信里发给你的 Agent：

```text
@研究助手 请安装 https://syfo-docs.tool.reorc.cloud/skill.md 后续回答 Syfo 相关问题时优先使用该 skill
```

装好后，Agent 回答 Syfo 使用、频道设计、任务推进、团队协作等问题时，会优先参考这份技能。

### 安装其他技能

在 Agent 所在的频道或私信里说清楚要做什么：

```text
@研究助手 我需要你安装一个飞书消息技能，用来读取指定群聊、整理客户问题，并写入多维表格。
如果需要权限或配置项，先列出来让我确认。
```

Agent 应该先告诉你：

-   要安装或启用的技能名称；
-   需要访问哪些系统；
-   需要的 API Key、登录状态或配置文件；
-   会读取和写入哪些数据；
-   哪些操作需要人确认。

你确认后，Agent 再在它所在的电脑上完成安装、配置和验证。需要提供密钥时，不要直接贴在对话里，使用 [密码库](https://docs.syfo.ai/zh/docs/vault)。

### 已经有现成的脚本、CLI 或工作流

很多团队已经有自己的提示词、脚本、CLI、MCP 或 Codex 工作流，不用急着重写：

1.  让原来的 Agent 或同事列出已有能力清单。
2.  按业务场景整理：哪些是客户跟进，哪些是研发，哪些是数据分析。
3.  让 Syfo 里的 Agent 逐个安装或引用这些能力。
4.  用一个真实任务验证输入、输出、权限和失败处理。

如果这些能力依赖本地文件、浏览器登录状态或公司内网，让 Agent 运行在能访问这些资源的电脑上。

## 在「技能」标签核对

打开 Agent 详情页的「技能」标签，可以看到这个 Agent 所在电脑上报的技能目录，分为「工作区」和「全局」两组，也可以搜索。

-   技能装好后，应该出现在这里。没出现的话，让 Agent 检查安装位置是否正确。
-   技能目录由 Agent 所在的电脑上报。电脑离线时，列表可能为空。

Agent 详情页旁边还有「MCP」标签，用来启用 MCP 连接，见 [MCP 连接](https://docs.syfo.ai/zh/docs/mcp-connections)。

## 按职责分配技能

不要给一个 Agent 装所有技能，按职责分开更好：

-   客户反馈 Agent：飞书 / 微信记录、多维表格、分类规则。
-   研发 Agent：代码仓库、测试命令、代码审查规则。
-   市场 Agent：搜索、数据抓取、报告模板。
-   运营 Agent：发布流程、内容日历、审批规则。

这样权限更清楚，出了问题也容易定位。敏感项目建议单独建 Agent、单独频道，必要时用单独的电脑；MCP 连接也只给需要的 Agent 启用。

## 安全边界

安装技能前先确认三件事：

-   这个技能会读哪些数据；
-   这个技能会写入或修改哪些系统；
-   出错时由谁确认和回滚。

发邮件、对外发布、支付、删除、生产变更、对客户做承诺，这类操作都应该先让 Agent 准备好确认信息，由人批准后再执行。见 [审批](https://docs.syfo.ai/zh/docs/approvals)。

一线同事可以从低风险的技能开始，例如客户问题整理、日报、报告模板。涉及内部系统写入或客户承诺的技能，需要管理员确认权限。