上传 Agent Skills：SKILL.md 技能包的打包与启用
Skill 是给 Agent 用的「任务操作手册」：一个文件夹里放一份 SKILL.md，说明完成某类任务的步骤、规则、模板，还能附带脚本。v4.13.0 起支持这种形式。它不限于某个厂商的模型，但要求模型能理解技能说明。
工具、MCP、技能、插件的分工
| 类型 | 提供什么 | 例子 |
|---|---|---|
| 工具 | 一个具体操作接口 | 搜索网页、读文件、执行 Python |
| MCP | 外部服务提供的工具 | 查日历、检索论文 |
| Skill | 完成任务的方法和资源 | 按团队模板整理周报、按规则分析表格 |
| 插件 | 扩展框架功能 | 注册指令、处理消息，也能自带工具和技能 |
技能的特点是按需加载：先只给 Agent 名称和描述，任务对口时才读全文，不占常驻上下文。
打包一份技能
目录结构里每个技能文件夹必须直接包含 SKILL.md：
weekly-report.zip
├── weekly-report/
│ ├── SKILL.md
│ └── references/
│ └── report-template.mdSKILL.md 的 frontmatter 写 name 和 description（description 说明做什么、什么时候用，Agent 靠它判断是否加载）：
---
name: weekly-report
description: 当用户需要把零散工作记录整理成周报时使用，按进展、阻塞和下周计划输出。
---
# 周报整理
1. 阅读用户提供的工作记录；缺少关键信息时先询问。
2. 分别整理已完成事项、进行中事项和阻塞。
3. 按「本周进展」「问题与风险」「下周计划」输出。
4. 保留日期、负责人和关键数据，不编造用户未提供的进展。打包要点：单技能包的 ZIP 名与文件夹名一致；标识只用英文字母、数字、点、下划线、短横线；别多套一层不含 SKILL.md 的仓库目录。
上传与环境配置
- 「插件 → 技能」→ 右下角 + 上传，可一次多个 ZIP；同名技能不会被覆盖，更新要先删旧的或先备份
- 配运行环境（配置文件 → AI → 能力 → 使用电脑能力）：本机环境（local）用框架所在环境读文件跑脚本；第三方沙箱（sandbox）在隔离环境里跑；none 则技能说明都读不了，别指望执行
- 配人格：在人格设定的技能列表里勾选该技能，保存
- 触发：聊天里明确提及——「使用 weekly-report 技能，把以下记录整理成周报」
管理与来源
技能列表支持启用/停用（停用保留文件）、在线编辑、导出 ZIP 备份、删除。来源有四处：本地上传（data/skills 目录）、插件内置、沙箱预置、工作区（按会话隔离），同名时优先级为工作区 > 本地 > 插件内置 > 沙箱。
关键认知
上传技能不会自动安装它需要的软件，也不会增加权限——技能要 Python 库、外部 API 或某工具，得另外配好；Agent 读到了说明却跑不了脚本，查运行环境、执行权限和依赖，排查思路同插件报错。用前先给个小任务验证输出，再交给重要工作。