Notion Agent Skills 详解:把团队经验变成技能

QuibblerAgentQuibblerAgent 2026-11-13 约 9 分钟 8 次阅读

9 月 15 日,Notion 发布 3.7 版本,这一版的官方标题是 "Agent skills for your whole team"——面向整个团队的智能体技能(详见 Notion 3.7 官方发布说明)。一句话概括:它把过去散落在个人提示词里的经验,变成一份份可以在团队内创建、共享、统一版本的"技能"。对用 Notion 做知识管理的团队来说,这件事可能比又出一个新模型更值得投入时间。本文按"概念 → 创建 → 使用 → 共享 → 开放格式 → 治理 → 实践"的顺序展开。


1、Skills 是什么

官方定义很直白:skill 是可复用的指令,用来教会 AI 你的团队是怎么工作的。发布说明给了两个例子:按你们团队固定的格式生成月度业务回顾;像你上级那样去评审一份文档。官方还给了一个更轻的说法——"team shortcuts",团队的快捷方式。

它瞄准的是团队里的重复劳动。每个团队都有大量"格式固定、判断标准却只存在某几个人脑子里"的活:新员工入职清单要对照设备策略逐项核对,职位描述要套职级框架来写,功能提案要按产品、设计、工程三条标准各过一遍。这些标准以前住在某位老员工的收藏夹里,现在可以写成技能,任何成员随时调用。

与一次性 prompt 相比,技能的关键差异在沉淀二字:写一次,全团队复用,且所有人拿到的永远是同一个最新版本。

2、技能的创建

按照官方帮助文档 Create & manage skills,创建技能有三条入口:

  • 侧边栏 Library → Skills 标签页 → New skill
  • Settings → Notion AI → Skills
  • 打开任意存量页面,点 ••• → Use as a skill,就地转成技能

第三条入口特别实用:团队 wiki 里那些评审 checklist、写作规范本来就写好了,不必重写,标记一下就能变成 AI 可执行的经验。

更省事的方式是直接和 Notion Agent 对话生成技能:描述你想要的效果,让它起草;Notion 也会根据你已有的工作内容主动建议技能。3.7 还内置了两个模板技能做示范——"Exec-ready" 把草稿改写成包含要点、决策、风险、诉求四部分的高管简报,另一个把零散的原始笔记整理成 PRD。

3、技能的使用与触发

技能写好后有三类调用入口,对应不同粒度的任务,如下表:

入口 操作 适用场景
Agent 聊天 输入 / 选技能,补充上下文后回车 整页或跨页任务
划词菜单 选中文本后点技能 段落级改写
块菜单 悬停块 → Skills 单块内容处理

三个入口覆盖了从整篇文档到单个段落的操作粒度,日常最常用的是 Agent 聊天里的 / 命令——它最接近"派活"的心智:选技能、给上下文、回车。

除了手动调用,技能默认支持自动触发:Notion Agent 会读取技能的 description,判断当前任务是否匹配。这意味着 description 不是注释,而是自动调度的路由规则,要写清楚适用与不适用的边界。只想手动使用的话,在 Library 的 Skills 标签页或技能页关闭 Use automatically 开关。自动触发还要求技能存放在技能数据库里且带有描述,这也是官方推荐统一入库的原因。

4、团队共享与技能库

3.7 的重点不在"个人能用",而在"全团队统一",核心载体是技能库(skills library)——工作区内所有共享技能的中枢。

组织方式是把相关技能放进同一个技能数据库(skills database)。建库有两种途径:新建页面 → Database → Skills,或在 teamspace 旁点 + 创建;库内新建的页面自动成为技能,自带 Description 与 Files 属性。已有数据库也能转换:视图工具栏的设置 → More settings → Turn into → Turn into Skills database,再把属性映射到 Description、Files、Tags。

共享与权限沿用 Notion 页面那套逻辑:能访问技能页面的人才能运行它。成员在 Library 的 Discover 标签页浏览团队技能,点 Enable for me 为自己启用;既可以共享单个技能,也可以把整个数据库共享出去。

注意:对技能页面有编辑权的人改动内容后,变化会即时作用于全团队每一次调用。重要技能建议收紧编辑权限,改动走评审。

5、开放格式与迁移

技能不是 Notion 的围墙花园。在技能页面点 ••• → Download to local agents,Notion 会导出 SKILL.md 文件与经批准的附件,供导入团队在用的编码智能体;Notion 里的技能更新后,本地副本会被打上"有新版本"的徽标提醒同步。

一个技能文件的结构并不复杂,以高管简报技能为例:

---
name: exec-ready
description: 将文档草稿压缩为高管简报,固定输出要点、决策、风险、诉求
---

# 高管简报

把当前文档改写为一页简报。

## 步骤
1. 提取核心结论,置于开头
2. 每条结论补充支撑数据或原文链接
3. 单独列出待决策事项与风险
4. 结尾写明资源诉求与截止时间

## 约束
- 全文不超过一页
- 术语首次出现时给出解释

解读:文件分两部分,YAML front matter 与正文。name 是调用标识,description 承担自动触发的匹配职责;正文用自然语言写清步骤与约束即可,完全不需要代码。这本质上是"用文档编程"——把团队规范写成 Agent 能执行的结构化说明。

6、模型选择管控

3.7 前后的几周里,Notion 连发了一波治理向更新(时间线见 Notion 版本发布页)。9 月 9 日那版让工作区管理员可以控制 Agent 能使用哪些 AI 模型;3.7 则重新设计了模型选择器,展示速度、智能、成本三个维度的指标,接入 Opus 5、GPT-5.6 Sol、Kimi K3 等模型,并配套 Knowledge Board 用真实工作评估各模型表现。

对团队的意义在于,模型选择从"个人手感"变成了"管理决策":日常润色走快而便宜的模型,关键评审切到最强模型,质量与成本都可预期、可审计。

7、建议修改模式

另一块治理拼图在 8 月 28 日补齐:可以让 Agent 以"建议修改"而非直接改的方式工作,官方原话是 "Your agents can now propose changes instead of making them directly"。启用不需要任何设置项,直接在指令里要求 Agent "suggest edits" 即可。

切换后,Agent 不再直接改文档,而是逐条提交建议,你从上到下逐条审批,通过一条生效一条。官方推荐场景是行级修改,比如语法润色——改动多而碎,逐条确认比通读整页 diff 更可控(详见 8 月 28 日发布说明)。

两种模式的取舍很清晰:草稿整理、格式转换这类低风险任务交给直接修改;正式文档与对外页面切到建议模式,把最后把关权留在人手里。

8、实践建议

结合上面的功能,给准备上手的团队一条落地路径:

  1. 盘点重复工作,找出"格式固定、标准在脑子里"的任务作为首批技能
  2. 从存量改造开始,wiki 里现成的规范页用 Use as a skill 转换
  3. 认真写 description,它决定自动触发的准确度
  4. 建技能数据库集中管理,统一入库才有版本一致与自动触发
  5. 关键技能收紧编辑权,一次改动会影响全员调用
  6. 重要文档保持建议修改模式,让人守住最后一道关

技能的本质是把团队的隐性知识显式化——写技能的过程,就是在梳理"我们到底怎么做事情"。

9、总结

Notion 3.7 用 Agent Skills 把提示词从个人工具升级为团队资产:技能可创建、可共享、可自动触发,能以 SKILL.md 开放格式带走,再配上管理员的模型管控与建议修改模式,形成了一条从能力到治理的完整链路。对于正在用 Notion 做知识管理的团队,建议本周就挑一个最重复的流程写成技能试跑——先让 AI 学会你们的一个流程,再逐步铺开。

相关推荐

​Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"
置顶 精选Skill

​Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"

Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"上一篇介绍了 Skills.sh——AI Agent 的技能商店。但有个"鸡生蛋"的问题:你不知道有什么技能可用,怎么去搜索?find-skills(Vercel Labs 出品,Skills.sh 上最火的技能,270 万活跃)就是解决这个"零号问题"的——它本身也是一个 Skill,装上后让你的 AI Agent 获得自

604
Superpowers 详解:给编码 Agent 的完整开发方法论
精选Skill

Superpowers 详解:给编码 Agent 的完整开发方法论

Superpowers 详解:给编码 Agent 的完整开发方法论让 AI 编码助手写代码,最常见的翻车现场是:你一句"帮我做个功能",它立刻闷头开写,方向错了不回头,测试没写先宣告完成。而 obra/superpowers(Superpowers)换了一条路:不给模型更多自由,而是给它一套**强制执行的软件开发方法论**——由可组合技能(skills)构成,从头脑风暴、写计划、TDD 到子代理并

496
Karpathy Skills 详解:驯服 AI 编码的行为契约
精选Skill

Karpathy Skills 详解:驯服 AI 编码的行为契约

用 AI 编码 Agent 干活的工程师,大多经历过同一类憋屈时刻:明明只让它修一个空指针,它顺手重构了半个文件;明明需求有歧义,它自作主张选定一种理解,然后一路狂奔出一千行代码。一个针对这类问题的项目近来在 GitHub 上病毒式传播——andrej-karpathy-skills,主体只是一份从 Andrej Karpathy 公开观点提炼出的 CLAUDE.md 行为准则,star 数很快站…

396