技能与插件

技能是告诉 ZAI 某类工作怎么做的说明、脚本和参考资料。ZAI 自带一批常用技能；团队还可以把自己的做法整理成插件，从 Git 仓库同步或在控制台上传到 Z Tag，再由组织决定在哪些聊天里使用。

自带的技能

ZAI 自带处理文档、表格、演示文稿和 PDF，调研与写作，设计与图像，测试网页应用等常用技能，按任务自动选用，不需要先建插件。想知道它现在有哪些技能，直接问它：“你有哪些技能？”

技能只提供做法，不提供权限。用技能处理任务时，ZAI 仍只能用当前聊天里可用的资源和网络。需要真实数据的结论（例如搜索量、排名、真实用户的访问性能），ZAI 不会凭页面外观推算；风险分级这类结论也不代表组织的批准。

你也可以让 ZAI 写一个技能，它交付的是技能文件或压缩包。要让团队以后都能用，请把它放进 Git 仓库同步，或者在控制台上传，再启用，见管理插件。让它写 MCP 服务时，交付的是服务代码和配置说明；服务部署到 https 地址后，可以在控制台填写成插件，或在插件里声明，见填写 MCP 服务。

插件

插件的内容来自连接器里一个 Git 仓库的一个目录（目录里有 Claude Code 插件市场的清单时，一个目录可以同步出多个插件），或者来自在控制台上传的一个压缩包。插件里可以有一个或多个技能（各带一个 SKILL.md），也可以有参考资料、脚本、图片和其他文件，ZAI 拿到的目录结构和仓库或压缩包里一致。插件还可以提供远程 MCP 服务，ZAI 把它们的工具和自己的工具一起使用，访问时由 Z Tag 附上连接器里的凭证，见填写 MCP 服务。一个插件要经过三步才会被用上：

1. 同步或上传：从 Git 仓库取指定的分支、标签或提交，或者上传一个新的压缩包，检查后发布成插件的一个新版本；内容没有变化时不出新版本。
2. 启用：组织把插件开放给群，授权给全体成员的私聊，或放进连接器，随连接器一起提供；成员也可以为自己的私聊建个人插件。
3. 加载：ZAI 开始处理一条消息时，加载当时已启用的插件。

同步或上传成功后，ZAI 正在回复的那一轮仍用原来的内容，见更新后从什么时候生效。新建、同步、上传和启用的操作，以及插件的内容要求和大小上限，见管理插件。

插件功能需要 Z Tag 管理员开启；没有开启时，控制台侧栏没有 插件，也不能新建、同步或上传插件。

更新后从什么时候生效

插件更新、启用、停用，或授权给全体成员的范围有变化后，ZAI 从下一条消息起使用新的内容，进行中的话题也是如此：

• ZAI 正在回复的那一轮不受影响，这一轮用的技能保持不变；回复过程中你补充的消息会打断这一轮，ZAI 从这条消息起按新版本接着做。
• 这一轮结束后，在原话题里发下一条消息，ZAI 就按新版本开始，不需要另开话题或重启。
• ZAI 在任务中申请的资源获批后接着做时，同样重新加载当时已启用的插件，审批带来的插件也在其中。

ZAI 自带的技能随 Z Tag 更新，更新后新的话题会用新版本。

如果插件下载或检查失败，这条消息以失败结束，ZAI 不会带着不完整的技能开始工作。组织修复插件后，重新发送消息即可。

同名技能用哪一个

不同插件之间，或插件与 ZAI 自带的技能之间有同名技能时，只加载一个：

1. ZAI 自带的平台说明（名字以 ztag- 开头）总是优先，插件不能替换它们。
2. 属于这个聊天所在一方的插件优先：群里是组织的插件；私聊里成员自己的个人插件，排在随连接器或全体成员授权进来的组织插件之前。
3. 插件的技能优先于 ZAI 自带的同名技能，可以用插件换掉某个自带技能的做法。

同一方的插件之间，按插件标识的字母顺序，排在前面的优先。插件标识是插件建好时定下、之后不再改变的英文短名，通常取插件 plugin.json 里的 name，改插件名称不影响它。插件标识相同的两个插件，只加载优先的那个。没有加载的技能，在控制台的 范围设置 里选中范围后标为 被遮蔽，见管理插件；问 ZAI “你有哪些技能？”时，它也能告诉你哪些技能因同名没有加载。

较早同步、没有技能清单的插件版本不参与这条规则：它按文件夹查找技能，同名技能仍会加载，名字后面加上 -2 等后缀区分；文件夹名以 ztag- 开头的技能不加载。重新同步一次就会生成带清单的新版本。

插件不提供权限

插件只提供做法和资料，不会给 ZAI 额外的权限。插件里的脚本访问业务系统、远程设备或 Z Tag 时，仍按当前聊天的授权检查。同步插件时用的仓库凭证和网络，只用于同步，ZAI 使用插件时拿不到它们。

不要在 Git 仓库或技能文件里存放令牌、密码或私钥。