# Skills

Source: https://docs.mira.day/zh/docs/agent-sourcing/skills

> 把常用的工作流保存为可复用的 Skill，在 Task 输入框输入 / 即可唤起。



Skill 能把你反复使用的工作流保存下来 —— 比如一套寻访需求格式、一份评估标准、一种报告结构 —— 之后在任何 Task 里直接复用，不必每次都从头描述同样的要求。

***

什么是 Skills [#什么是-skills]

Skill 是一组保存好的指令，告诉 Mira 如何处理某类重复出现的工作。Skill 归属于你的账号，分为两类：

* **官方 Skill**：由 Mira 团队构建和维护。第一个官方 Skill 是 **skill-creator**，它通过对话帮你创建和编辑自己的 Skill。
* **个人 Skill**：由你自己创建，仅你的账号可见。

唤起 Skill [#唤起-skill]

1. 在 Task 输入框输入 **/**，会弹出 Skill 选择器，列出你可用的 Skill。
2. 选中一个 Skill，或继续输入按名称筛选。
3. 描述这次任务的具体要求并发送。Skill 名称会以标签形式出现在你的消息里，Mira 会按该 Skill 的指令执行这个 Task。

{/* TODO: screenshot — Task input with "/" skill picker open */}

Mira 也会自动应用合适的 Skill：每个 Skill 都带有一段简短描述，当你的请求与之匹配时，Mira 会自行调用该 Skill。

创建 Skill [#创建-skill]

前往 **Settings → Skills**（设置 → Skills），点击 **New Skill**（新建 Skill）。有两种方式：

Create via Chat [#create-via-chat]

选择 **Create via Chat**（对话创建）。Mira 会带着官方 **skill-creator** Skill 打开一个新 Task，通过对话把你描述的工作流变成一个保存好的 Skill。

Import File [#import-file]

选择 **Import File**（导入文件），拖入一个 `SKILL.md`、`.skill` 或 `.zip` 文件（最大 10 MB）。一个 Skill 包由以下内容组成：

* `SKILL.md` —— 必需。frontmatter 中包含 Skill ID（slug）和一段简短描述（保持简洁；最多 1024 个字符）—— Mira 用它判断何时自动应用该 Skill —— 之后是 markdown 格式的指令（最大 100 KB）。
* 可选的 `scripts/`、`references/` 和 `assets/` 文件夹，用于存放辅助文件。

如果名称与你已有的 Skill 或某个官方 Skill 重名，请在 `SKILL.md` 的 frontmatter 中改名后重新上传。

编辑 Skill [#编辑-skill]

* **在 Settings 中编辑**：在 **Settings → Skills** 打开该 Skill，点击 **Edit**（编辑）直接修改它的描述或指令。
* **通过对话编辑**：在 Skill 详情页把编辑工作交给 **skill-creator** —— Mira 会接续在一个 Task 中处理，并替你完成修改。

管理你的 Skill [#管理你的-skill]

**Settings → Skills** 以 **Official**（官方）和 **Personal**（个人）两个标签页列出全部 Skill。

{/* TODO: screenshot — Settings → Skills list page */}

对于每个 Skill，你可以：

* 用开关**启用或停用**它。停用的 Skill 不会被使用。
* **导出**为 `.skill` 文件。
* **永久删除**。这会一并移除 `SKILL.md` 以及 `scripts/`、`references/`、`assets/` 下的全部内容，且无法撤销。

FAQ [#faq]

目前有哪些官方 Skill？ [#目前有哪些官方-skill]

目前是 **skill-creator**，用于通过对话创建和编辑个人 Skill。Mira 团队发布新的官方 Skill 后，会出现在 **Official** 标签页中。

Skill 里面有什么？ [#skill-里面有什么]

一个 `SKILL.md` 文件，包含该 Skill 的 ID、描述和 markdown 指令，外加可选的 `scripts/`、`references/`、`assets/` 文件夹，用于存放辅助文件。

可以把 Skill 分享给同事吗？ [#可以把-skill-分享给同事吗]

目前还没有内置的分享功能。你可以把 Skill 导出为 `.skill` 文件，任何人都能在 **Settings → Skills → New Skill → Import File** 中导入。

相关页面 [#相关页面]

* [Agentic Search](/zh/docs/agent-sourcing/agentic-search)：Skill 所依托的搜索流程。
* [语音输入](/zh/docs/agent-sourcing/voice-input)：另一种更快说清需求的方式。