AI技能是一组可供AI工具反复使用的指令。对团队而言，它的价值不只在于一次写好指令：修正必须传达到每一位使用该技能的人。一种实用的做法是把可编辑版本放在Notion中，通过GitHub分发，并让更新后的指令能在Claude Code等工具中使用。

为团队提供唯一的编辑位置

当某个人在私人聊天中改进了工作流程，同事可能仍在使用旧版本。这项修正可能随着那段对话一起消失，而无法成为团队工作指令的一部分。Notion的共享技能数据库让员工可以查看、评论并修改同一批页面。智能体也可以通过Notion MCP处理这些页面。Notion MCP是一种让AI工具访问Notion内容的连接。

这种分工对不在GitHub中管理文件的人很重要。文案和制片人可以编辑熟悉的页面，文件分发则由GitHub在后台完成。它还让负责实际业务的人参与编辑过程，而不是把技能完全交给配置AI工具的人。

几只手在整理好的参考资料旁，重新排列共享板上的空白指令卡片。

▲ 共同编辑技能

把页面上的技能送到共享工具

基本配置从一个Notion页面开始，页面中写明技能的目标、必要输入、规则和工作流程。团队可以在页面设置中先选择 Use with AI，再选择 Use as AI skill，然后把该页面放入中央技能数据库。

把技能从Notion送到团队所用工具需要三个步骤，其中第一步仅用于测试：

  1. 快速测试时在本地安装。 命令npx skills@latest add notion --global会找出可用的Notion技能，并提供安装到包括Claude Code在内的受支持工具的选项。符号链接（symlink）让本地各工具指向同一份已安装文件，而不必各自保留副本。之后，Claude Code可以用/skills列出已注册的技能。
  2. 团队使用时设置仓库同步。 仅在本地安装只是一份快照：修改Notion页面并不会自动获取新内容。在共享配置中，定时运行的GitHub Action（在仓库中运行的自动化任务）读取Notion技能数据库，并把每个技能写入GitHub中的SKILL.md文件。
  3. 在Claude中安装仓库里的技能。 可以通过Claude的Plugins插件市场添加该仓库，团队成员随后可以逐个安装技能。仓库更新后，插件管理器可以自动刷新；测试时可以用 Check for updates 获取刚同步的版本。

在这套技能库配置中，GitHub Action每小时检查一次Notion。用于同步的Notion连接获得对指定Skills数据库的读取权限，其令牌以NOTION_API_TOKEN的名称保存在GitHub Actions的密钥中，而不是写在仓库文件里。编辑工作仍在Notion中完成。这一区分很重要：符号链接让本地安装保持一致，而把后续页面修改带到共享仓库的是从Notion到GitHub的流水线。

最初的邮件文案测试中，Claude Code找到了已注册的技能，通过Notion获取活动背景信息，并把三份草稿写入项目数据库。这次运行耗时9分23秒。它说明的是一项任务已经完成，而不是速度或输出质量的普遍预期。

用实际工作改进指令

一家视频制作公司把这种方法用于两个工作流程：脚本写作，以及制片人与客户的沟通。最初的技能依据两次约45分钟的首席制片人访谈，以及访谈记录、标准作业流程和一份已获批准的参考脚本建立。访谈发现了通用指令模板可能遗漏的细节：写作者动笔前需要哪些信息、简报存放在哪里、材料相互矛盾时如何处理，以及初级写作者常犯哪些错误。

一个用于创建技能的智能体在Notion AI中搭建了第一个脚本写作技能，其中包括结构规则，以及把输出放入正确Notion数据库的说明。团队随后在另一个项目上测试，检查创意概念和草稿是否符合要求，是否提到了并不存在的素材。对这项创意任务而言，目标是先提供脚本中有用的前15～20%，而不是跳过写作者判断的成品。

在后来的一次草稿审阅之后，反馈循环变得更加清晰。一个用于编辑技能的智能体更新了Notion中的指令，要求在提出新创意之前先检查项目的当前状态和以往反馈。每小时运行的GitHub任务把修改后的指令带入仓库。插件刷新后，在另一个聊天中的运行遵循了新增的检查步骤。一项始于单次草稿审阅的修正，就此成为共享技能的一部分。

修改后的指令经由文件夹传到多台工作站，一名审阅者正在调整空白草稿卡片。

▲ 反馈经共享技能传递

另一家辅导培训企业的部署采用了同一模式的更快版本。其工作区有9个专门智能体，负责文案、演示文稿和营销活动等任务。企业主可以在Notion中修改运行指令；GitHub Action每五分钟检查一次变化，仓库中的新提交会触发重新构建和重新部署。每五分钟检查一次只适用于这次部署，与技能库示例中每小时一次的安排不同。

这个商业案例说明了什么，又没有说明什么

这家视频制作公司为涵盖两个共享技能的初期实施支付了$1,000。这是该案例的价格，并不能证明其他团队会赚到或节省特定金额。更有参考价值的或许是试点范围：它聚焦于两个现有且费时费力的工作流程，而不是一次性替换团队的整套运营体系。

从人能审阅的工作流程开始

选择一两项输入明确、经常需要修改的任务。访谈实际执行这些任务的人，把他们的规则和参考材料整理成Notion中的共享技能，并请这些实际执行者审阅第一版。用真实项目材料测试，记录输出遗漏了什么，再修改中央页面。如果多人或多个工具需要使用这个技能，在认定修正已传达到团队之前，要同时确认GitHub同步和已安装的版本。