创建和管理技能

当整个团队共享技能时，它们会变得更有用。Notion 为你的团队提供了一个共享技能库，每个代理都可以使用。

• 适用于整个团队。 任何人都可以使用 Notion 编辑器编写技能，无需 markdown。团队成员可以留下评论和编辑建议，技能还可以链接到工作空间中的任何页面。

• 适用于所有代理。 只需将代理连接到 Notion 一次，它就会实时加载你的技能。你还可以将技能同步到 GitHub 或下载到本地代理。

• 内置控制功能。 技能即页面，因此页面权限和版本历史同样适用。管理员可以为工作空间中的每个人安装技能，数据分析功能还能显示每项技能的使用频率。

技能是 Notion 中使用 AI 的几种方式之一。以下是每种方式的比较：

在以下任务中使用技能：

• 可重复：你或你的团队经常执行此操作。

• 上下文相关： 它需要立即在特定的选定内容或页面上运行。

• 一致性： 您希望每次都获得相同的结构或质量。

如果你需要把同一条（文字）指令复制粘贴两次，就可以考虑把它做成技能。

• 高管级重写（语气、长度、格式）。

• 将会议记录转换为待办事项或总结邮件。

• 将草稿转换为特定模板（常见问题、PRD 摘要、规范框架）。

• 标准化文档格式（项目符号、标题、样式）。

1. 前往侧边栏中的 库，然后打开 技能 选项卡。

2. 选择 新技能。

3. Notion 会创建一个新的私人技能页面并将其打开。编写你的指令，然后添加一个 描述，说明该技能的功能以及使用场景。

你的库可能有多个选项卡，因此 技能 选项卡可能不是你看到的第一个选项卡。你也可以通过在 Notion 代理对话中输入 / 来查看你的技能。然后，选择 查看库中所有技能。

每个技能页面都有一个 描述 字段和一个 文件 字段。使用 文件 来存放示例、模板或脚本等辅助材料。

在任意页面，选择顶部的 •••，选择 使用 AI，然后选择 用作 AI 技能。

你也可以让 Notion 代理为你将页面标记为技能。

技能页面顶部会显示技能控件，例如 已启用 开关和 运行，以便你将其与普通页面区分开来。

如果你已经将技能保存为 SKILL.md 文件，可以将它们导入 Notion：

• 上传技能： 在 库 → 技能 中，选择 更多添加技能的方式 → 上传技能。你可以上传 .md 或 .zip 文件。

• 让你的代理帮忙： 当你 连接代理 时，它会主动提出将电脑上找到的技能上传到 Notion。你以后也可以让它上传技能文件夹。

• 将操作指南数据库转化为技能： 了解如何将现有数据库转化为技能数据库 →

启用某项技能后，你就可以在 Notion 代理和已连接的代理中使用它。禁用后，两者都无法再使用该技能。

1. 前往库 → 技能。

2. 打开技能旁边为我启用列中的开关。

若要让某项技能仅在 Notion 代理中可用，而不在已连接的代理中可用，请打开该技能的设置菜单（技能旁边或技能页面顶部的滑块图标）。在其他代理下，将鼠标悬停在在已连接的代理中使用上，然后选择已禁用。

你的选择只对自己有效，不会影响其他成员看到的内容。

您可以通过高亮显示文本、将鼠标悬停在区块上或在内容旁边输入 /，来自动运行技能或从编辑器中运行技能。

在与 Notion Agent 聊天时，输入 / 即可查看你已添加的所有技能菜单，或输入 / 后紧跟技能名称直接运行该技能。

Notion Agent 可以在你不通过名称调用它们的情况下使用你的技能。只需描述你的需求，如果某个技能适用，Notion Agent 就会自动使用它。具体操作如下：

• 自动使用功能默认开启，因此 Notion Agent 可以在技能准备就绪后立即开始使用。

  • 如果你希望某项技能只在你要求时运行，请打开该技能的设置菜单。在Notion Agent下，将自动使用设置为已禁用。

• 技能需要描述才能自动运行。在技能页面顶部的描述 字段中添加描述，或者如果技能位于技能数据库中，则在描述属性中添加。

• Notion Agent 会读取描述以确定该技能是否匹配，因此请确保描述清晰且具体。

选择一段文本，然后从文本选择菜单中选择一项技能。

只有设置为在页面中显示的技能才会出现在这些菜单中。要更改此设置，请在库的技能选项卡中打开技能的设置菜单，然后选择显示技能。你的自定义技能会首先显示，随后是内置的默认技能：优化写作、校对、解释和重新格式化。

在斜杠菜单中：

• 在内容旁边输入 /skill 以浏览您可用的技能。斜杠菜单仅在行内有内容时才会显示技能，因为技能需要作用于特定内容。

• 在与 Notion Agent 聊天时，您也可以输入 / 后跟技能名称，直接使用特定技能。除非旁边有内容，否则此快捷方式在页面上无法使用。

在区块菜单中：

• 点击将鼠标悬停在区块上时出现的 ⁚⁚ 图标，以打开区块菜单。

• 选择 技能。

• 选择一项技能以在该区块上运行它。

技能可用于文本、标题（H1、H2、H3）、引用、标注、项目符号列表、编号列表、待办事项、折叠列表、图像和同步块。技能不会出现在空块或此列表之外的块类型中。如果您将技能应用于包含嵌套内容的块，该技能也会包含这些嵌套内容。

Notion 可以在你的 AI 会议速记中推荐技能，让你点一下就能处理会议事项。

1. 打开一份正在转录的会议速记，或一份已有摘要的会议速记。

2. 你会在会议速记中看到推荐的技能。也可以点击速记底部一角的头像图标，打开 Notion 代理查看这些技能。

3. 选择一项推荐的技能并运行，例如在会议期间总结决策，或在会议结束后创建后续任务。你也可以在这里创建新技能。

会议期间和结束后，你看到的推荐技能会有所不同。要选择会议速记中显示哪些技能，请前往库 → 技能，打开技能的设置菜单，选择显示技能，然后开启会议期间、会议结束后，或同时开启两项。每个列表最多可显示 12 项技能。

了解更多：AI 会议记录 →

有三种方法可以在 Notion 之外使用你的 Notion 技能。无论采用哪种方法，技能都仍在 Notion 中编写和维护。

通过 MCP 连接到 Notion 的代理可以在每次会话开始时从 Notion 加载你的技能，并为任务选择合适的技能。当你在 Notion 中编辑技能时，每个已连接的代理都会获得更新后的技能。你首先需要一个正常运行的 Notion MCP 连接。

1. 打开 资料库 → 技能。

2. 在显示 要在已连接的代理中使用你的技能吗？ 的横幅中选择 设置。

3. 选择 拷贝，拷贝设置用的文字指令。

4. 把文字指令粘贴到与代理的新对话中，然后跟着提示操作。代理会在自己的指令中添加一行，以便每次会话都加载你的技能，还会询问你是否要上传电脑上已有的技能。

每个代理应用都需要单独设置。如果你同时使用 Claude 和 Cursor，请分别在这两个应用中运行设置用的文字指令。

GitHub 同步功能每小时会将你的 Notion 技能拷贝到 GitHub 仓库。管理员可以将该仓库添加为 Claude 或 ChatGPTcodex 中的插件市场，让这些应用中的所有人都能使用这些技能。开始使用开源项目 Notion skills GitHub sync。

将技能副本发送到 Claude Code、Codex、Cursor、Gemini 或 Grok Build 等本地代理。只要你的工作空间允许下载本地技能，就可以在 Notion 桌面应用中使用此功能。

1. 在 Notion 桌面应用中打开技能页面。

2. 打开页面顶部的技能设置菜单（滑块图标）。

3. 在 其他代理 下，选择 下载供本地代理使用，然后选择要将技能发送到哪里。

Notion 会将技能保存为 SKILL.md 文件，并在安装任何附带文件前征求你的同意。如果 Notion 中的技能发生变化，已下载的副本就会标记为过期，提醒你重新下载。

开发者还可以通过 Agent Skills API 列出、下载和上传技能。查看开发者文档 →

技能数据库为您的团队提供了一个共同创建和管理技能的地方。您在其中创建的每个页面都会自动成为一项技能，并且每项技能都会获得一个描述属性。Notion Agent 会读取该描述，以决定何时自行使用该技能。

技能数据库的工作方式与其他任何 Notion 数据库一样，并为你预设了几个属性：

• Description 说明了技能的用途以及使用时机。Notion Agent 会读取该内容，以判断何时适用该技能。

• Files 用于存放支持材料，例如示例、参考文档、图像、数据文件或脚本。

你可以添加团队关心的任何其他属性，例如 Owner 以显示谁负责保持技能的最新状态，或 Status 以显示哪些技能已准备就绪。

从一个共享技能数据库开始

当同一群组使用这些技能，且由同一批人负责更新时，使用一个数据库效果很好，因为每个人都知道首先该去哪里查找。当某个群组需要不同的访问权限、不同的所有者，或者需要在共享前先在一个地方完善技能时，可以添加另一个团队数据库或私人数据库

数据库与技能库

技能库不是数据库，而是一个视图，汇总了你有权访问的工作空间内各个数据库中的技能。

• 创建一个新页面，选择 数据库，然后选择 技能（或 /数据库・内嵌 → 技能）。

• 或者选择团队协作区名称旁边的 + 并选择相同的选项。

在团队协作区中创建它，意味着你的团队可以立即访问，因此你无需稍后移动它或更改访问权限。

1. 打开数据库。

2. 在视图工具栏中，打开设置（滑块）。

3. 在设置窗格中，选择 More settings → 转换成。

4. 选择 转换为技能数据库。

5. 你会看到一个设置对话框。选择将哪些现有属性映射到 描述、文件 和 标签，也可以保留默认设置，创建新属性。如果想立即为自己启用现有页面作为技能，请勾选 为我启用技能 复选框（其中会显示页面数量）。

从那时起，在数据库中创建的每个页面都将成为技能。当数据库中的页面已经解释了如何完成任务，比如一系列手册或操作指南时，这种方式效果最佳。

如果你已经有一个解释如何执行可重复任务的页面，请将其移动到技能数据库中。该页面将成为一项技能并获取技能属性，包括 Description。

1. 打开页面并选择 •••，然后选择 移动到。

2. 选择你的技能数据库。

3. 添加清晰的 Description，以便 Notion Agent 知道何时使用它。

编辑技能

你可以从文本选择菜单或区块菜单中编辑技能。

要从文本选择菜单编辑技能内容，请将鼠标悬停在技能名称上，选择铅笔图标。你也可以从资料库或技能数据库中打开技能页面进行编辑。

从库中管理技能

1. 前往侧边栏中的 库，然后打开 技能 选项卡。

2. 在此处，您可以查看现有技能、添加新技能，并打开任何技能页面进行编辑。

3. 要选择技能的显示位置，请打开其设置菜单并选择 显示技能。选择 在页面中，使其显示在文本编辑器、斜杠菜单和区块菜单中；选择 在对话中，使其显示在 Notion 代理对话中；选择 会议期间 或 会议结束后，使其显示在会议记录中。

从文本编辑器管理技能

高亮显示任意文本，然后选择菜单中技能旁边的 管理技能。

• 库的 发现 选项卡显示了他人与你共享的技能页面，以便你可以浏览团队构建的内容。

• 找到你想要的技能了吗？打开 为我启用 列中的开关，将其添加到你自己的技能中。

由于技能是页面，因此其共享方式与 Notion 中的任何其他页面相同。

• 如果你与他人共享技能，他们一旦获得该技能页面的访问权限，即可运行该技能。

• 如果他们可以编辑该技能页面，他们的编辑内容将会更改该技能。

• 通过前往侧边栏中的 库 并打开 技能 选项卡，查看你创建的技能、与你共享的技能以及工作区中的技能。

• 共享的技能页面表现得与常规页面一样，因此它们也会显示在你的库中的 已共享 下。

• 当只有部分人员需要某个工作流程时，请共享单个技能页面。当你的团队需要获取其中的所有技能时，请共享整个技能数据库

• 任何拥有编辑权限的人都可以为所有使用该技能的人更改共享技能，因此在选择编辑者时请考虑这一点。如果需要回溯，页面历史会显示具体的更改内容

• 已连接的代理只能看到你在 Notion 中有权访问的技能。

拥有访问权限和启用技能是两码事。访问权限决定谁能打开或编辑技能；启用技能则决定它是否出现在你自己的技能菜单中。与你共享的技能会出现在资料库的 发现 选项卡中，你可以通过 为我启用 列启用它们。

技能数据分析会显示技能在 Notion 和其他代理中的运行频率。

• 在资料库中：资料库 → 技能 中的 使用次数 列会显示过去 28 天内，工作空间成员使用各项技能的次数，包括通过 MCP 在已连接代理中的使用次数。

• 对于单个技能：打开技能的设置菜单并选择 查看数据分析，以查看其使用情况随时间的变化。

新的使用记录可能需要几个小时才能显示出来。

工作空间所有者可以选择为所有人安装技能，让整个团队一开始就用上同一套技能。前往 设置 → Notion AI → 常规，在 技能 部分找到 默认工作空间技能。

1. 选择技能的使用对象：工作空间中的所有人，或特定群组。

2. 选择 添加技能，然后挑选要安装的技能。

3. 对于每个技能，选择其显示位置，例如在对话中或页面中。

默认技能会自动为成员安装，也会添加到他们已连接的代理中。成员仍可为自己关闭默认技能。

技能部分还提供相关设置，可关闭整个工作空间的技能、已连接代理中的技能，以及本地技能下载功能。

根据你的需求，有几种移除技能的方法：

• 彻底删除技能： 技能是一个页面，因此你可以像处理其他页面一样将其移至垃圾箱。这同样适用于技能数据库中的技能页面。请注意，删除页面后，所有使用该技能的人都无法再使用它。

• 移除你添加的技能：如果你从 发现 选项卡添加了技能，现在不想用了，请关闭 为我启用 列中的开关。你可以在

  资料库的 技能 选项卡中找到它。这样一来，你的 Notion 代理和关联的代理就不会再使用该技能，其他人仍可使用。

• 将技能页面变回普通页面：选择页面顶部的 •••，选择 与 AI 配合使用，然后取消勾选 用作 AI 技能。你也可以在技能的设置菜单中选择 取消将页面设为技能。页面及其内容仍保留在原处，但该页面不再是技能。

• 使用你的 Notion Agent 来帮助构思或编写技能。

• 从您每周执行的常见工作流程开始，例如重写、回顾、总结或格式化。

• 像编写强有力的（文字）指令一样编写你的技能，包括目标、输入、约束和所需的输出格式。

• 明确输出要求，例如“返回 5 个要点”或“包含风险和后续步骤”。

• 保持技能页面简短，并在需要时链接到更长的参考资料。

• 随着你了解什么最有效，通过更新技能页面不断迭代。

• 为每个技能提供清晰的描述，说明其功能以及何时使用。Notion 代理和你关联的代理会根据描述自行选择合适的技能。

• 如果你的团队也在使用本地代理，请保持 Notion 中的技能页面为最新状态，并在进行更改后重新下载。

• 为每个共享技能指定一名所有者，以便在你团队的流程发生变化时，由专人负责更新

代理在选择技能之前，会读取你已开启的每个技能的名称和描述。这些限制能让列表保持精简，帮助代理快速选择合适的技能：

如果关联的代理没有加载你的某些技能，请关闭你不需要在关联的代理中使用的技能。