企业官网建设流程全解析

OpenWork 技能与插件实用指南：从创建第一个技能到团队共享

【免费下载链接】openworkThe open-source alternative to Claude Cowork (powered by opencode)项目地址: https://gitcode.com/GitHub_Trending/ope/openwork

如果你用过 OpenWork 的对话功能，迟早会碰到两个需求：让 Agent 重复执行某套固定流程，或者给 Agent 挂上额外的能力包。这两个需求分别对应 OpenWork 里的"技能（Skill）"和"插件（Plugin）"。本文按实际操作路径讲清楚它们各自解决什么问题、在界面哪里找到入口、如何创建和安装，以及团队共享时容易踩的坑。

先分清：Connector、Skill、Plugin 各管什么

OpenWork 官方文档把这三者定义为三个不同的构件，混用会浪费大量排查时间。

一个关键事实：底层一切皆是插件。你让 OpenWork 创建一个技能时，它实际生成的是"只含这一个技能的小插件"，所以日常不需要纠结"用技能还是用插件"。真正的插件用例是：一个薄弱的 Connector 配上多条系统技能时才需要打包，比如给工单系统配了六条操作规则，就应捆成一个"工单单元"整体分发。参考文档：skills-plugins-and-mcp.mdx

管理入口：Settings 里的 Library 与插件页

桌面端所有可用能力集中在Settings > Library，页面按Available apps、Your apps分组展示；按类别筛选时会出现 Skills、Plugins、Connections 等分栏，源码在 extensions-view.tsx。

插件管理单独一页，源码是 plugins-view.tsx，页面上有几个值得记住的控件：

• Project / Global 切换按钮：决定插件挂在当前工作区还是全局生效。选 Project 时必须已选中一个工作区根目录，否则"添加"按钮是灰的
• 建议插件列表：每个条目带名称、包名、标签，右侧是Add按钮；安装后按钮变为已添加状态
• Setup 引导：部分插件标记为 guided 安装，点击Setup会展开分步说明
• 配置路径显示：页面顶部会展示当前插件配置文件路径，出问题时先看这里

创建技能的三条路径

三条路径的产物相同：一个装在你的 Cloud 组织里的私有插件中的技能。区别只是操作位置。

路径一：从对话直接生成。先把任务在聊天里完整做一遍，保持会话不关，然后用自然语言说一句"把刚才我们做的事变成一个可复用的技能给我"。OpenWork 会把它存为私有插件并给你一张确认卡片，卡片上有技能名和跳转到 Library 的链接。之后在聊天中按名字调用，或描述同类任务让系统自动匹配。

路径二：桌面端 Library 手动添加。打开Settings > Library，筛选到 Skills，点击Add skill，在弹窗里填名称、描述、技能正文和可用范围。此路径需要已登录 OpenWork Cloud。

路径三：Cloud 控制台。管理员在Plugin Directory里打开（或新建）一个插件，点Add skill进入编辑器：

命名上给技能取一个明确的名字，描述里写清楚"Agent 应该在什么情况下使用它"，这两项决定了后续能不能被正确触发。

纯本地方案：如果你不想用 Cloud，也可以在聊天中明确要求"创建本地技能"。此时只会在工作区生成一个SKILL.md文件（如.opencode/skills/<name>/SKILL.md），无需账号，在Settings > Library里依然可见，但 Cloud 无法替你向团队分发或更新它。

安装、移除与回退插件

插件视图的Add按钮调用的是 plugins-view.tsx 里的addPlugin方法，传入包名即可；移除对应removePlugin。实际使用建议按这个顺序操作：

1. 先切到 Global 范围装通用能力，再切回 Project 装项目专属的
2. 装完点刷新按钮，确认列表里出现且状态正常
3. 出问题时不要立刻重装，先看页面顶部的配置路径，确认包是否真的写进了配置文件
4. 移除后如果行为没变，通常是作用域没切对——项目级插件在全局范围是看不到的

安装失败的两种高频原因：网络不通，或当前用户没有编辑插件的权限（页面会显示 accessHint 提示文案）。

团队共享的正确姿势

创建技能不等于发布技能，共享是单独的主动步骤：

1. 在 Cloud 控制台插件的Share区域，选择一个Collection（集合）。没有就先去Collections新建一个再回来
2. 打开该 Collection，用Who can access this授权给全组织、指定团队或指定成员
3. 被分配的成员在桌面端Settings > Library里即可看到这个插件及其技能

两个容易踩的坑：

• 改共享技能前先想清楚受众。编辑团队插件意味着所有被分配到该 Collection 的人都会收到变更。如果只是想个人微调，新建一个私有插件把指令拷过去改，或者新建一个技能让它"先执行共享技能，再附加我的额外指令"
• 个人技能与团队技能分开存放。个人偏好类技能保持独立；描述"系统规则"（如何提报事故单、如何写客户备注）的技能才进插件分发给全团队

下一步建议：先用"路径一"把你最近重复做过的一件事固化成技能，跑通一次调用，再决定是否打包进插件分发给同事。

【免费下载链接】openworkThe open-source alternative to Claude Cowork (powered by opencode)项目地址: https://gitcode.com/GitHub_Trending/ope/openwork