OpenWork 插件安装与技能调优：三分钟实操详解

OpenWork 插件安装与技能调优：三分钟实操详解

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

本文面向刚开始使用 OpenWork（开源版 Claude Cowork 替代品）的开发者：讲清在桌面应用与云端面板里如何完成插件安装、技能调优和日常排障，并理清 connector、skill、plugin 三种扩展单元的边界与配合方式。

动手前先分清三种扩展单元

OpenWork 给 agent 提供的是一小套积木：connector 负责连通系统，skill 是执行剧本，plugin 是把它们装在一起的发行包。

• Connector：组织级添加的 MCP 服务，连上之后 agent 获得在该系统中执行操作的能力；
• Skill：一段书面指令，任务匹配时由 agent 加载，适合把重复性工作的"标准做法"沉淀下来；
• Plugin：把技能、MCP 服务器等组件打包成一件事物，便于整体分发。

别纠结"技能还是插件"：底层一切都是 plugin。你让 OpenWork 创建一个技能时，它实际生成的是包含这一个技能的小型插件。真正的分界点在分发：如果五六个技能共同让某个系统变得好用，就把它们捆成一个 plugin 一起分发；如果只是个人习惯，技能保持独立即可。

看自己装了什么：桌面应用里进Settings > Library，云端面板有同名入口。列表按类型（app、connection、mcp、skill、command、agent、plugin）分组过滤，分类定义见 extension-taxonomy.ts，视图实现在 extensions-view.tsx。列表里没有的服务，用 "Add Custom App" 手动接入。

三分钟装好第一个插件

进Settings > Plugins，就是 插件视图组件。面板分三块：推荐插件卡片、已安装列表、手动添加输入框。

project 与 global 两种作用域

两种作用域的区别：面板顶部是 project / global 两个切换钮。project 作用域写入当前工作区的插件配置文件，只影响这个工作区；global 作用域是用户级，环境不支持时按钮会置灰。project 作用域需要先选一个工作区根目录才能开始添加，当前配置文件路径直接显示在面板上，需要时可手工编辑。

处理带引导的插件：部分推荐插件带 Setup 按钮。点开后展开分步说明，每一步都给出描述、可执行命令或路径，跟着做完再按 Add 即可。

手动添加一行命令搞定

底部输入框填包名（比如opencode-wakatime），按 Add，addPlugin直接执行安装。完成后状态行会显示结果，已安装的插件点 Remove 即可移除。

把技能写成剧本并调优

技能本质是一份剧本。典型场景是把"系统规则"写进去：开事故单该填哪些字段、更新客户备注时如何不丢上下文、绕开某个不稳定的工单动作。这些描述的是系统而不是某个人风格，用这套系统的每个人都需要。

剧本式写法

写技能内容时盯住三件事：触发条件（什么任务该加载这个技能）、执行步骤（顺序与安全的操作序列）、约束（必填字段、禁止动作）。技能可以进云端技能编辑器直接改：

验证技能是否生效

发布后先在 Library 确认技能状态为 ready，再开新会话发一条匹配触发条件的任务，观察 agent 是否按剧本执行。没生效多半是触发条件写得过宽，把它收紧到具体任务类型。

排障速查：插件和技能不对劲时

从个人用到团队分发

把技能捆成插件再分发：多个技能服务同一个系统时，打包成单个 plugin 再发出去，对方一次安装拿到整套。官方文档把这套选择原则写得很清楚：connector 管系统、plugin 管"让系统可用的一批技能"，见 extensions 单元说明。个人技能保持独立：单人工作流或私有习惯不必强行打包，团队需要成套时再合并。

读完这篇，直接进Settings > Plugins，从推荐卡片里挑一个按下 Add，再用 Library 确认它出现在列表里。

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