从零构建自己的AI工作插件knowledge-work-plugins五阶段引导式工作流完整教程【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-pluginsknowledge-work-plugins 是一个面向知识工作者的开源 AI 工作插件仓库为 Claude Cowork 提供了 11 个开箱即用的角色插件。更棒的是它内置了create-cowork-plugin技能——通过一套五阶段引导式工作流即使不懂代码你也能用对话的方式从零构建出属于自己的 AI 插件并打包成可直接安装的.plugin文件。本教程带你完整走一遍这条构建流水线 动手前 30 秒先搞懂 AI 插件的 4 种核心组件在开始之前先花 30 秒建立概念。一个插件本质上是一个文件夹最多包含 4 类组件组件位置通俗理解Skills 技能skills/*/SKILL.md插件的知识大脑Claude 会自动按需调用MCP Servers 连接器.mcp.json把 Claude 接到你的外部工具CRM、看板、数据库Agents 子代理agents/*.md独立执行多步任务的专职员工不常用Hooks 钩子hooks/hooks.json事件自动触发的守门员罕见 对大多数用户只写 1~3 个 Skill 就足够构建一个有用的插件——这正是官方从小处着手的最佳实践。标准的插件目录结构如下来自 SKILL.mdplugin-name/ ├── .claude-plugin/plugin.json # 插件清单必需 ├── skills/skill-name/SKILL.md # 技能定义 ├── agents/ # 子代理可选 ├── .mcp.json # 外部工具连接可选 └── README.md如何启动构建用对话代替写代码在 Cowork 桌面版中直接对 Claude 说帮我创建一个 XX 插件create-cowork-plugin技能就会自动接管随后带你依次走完下面五个阶段。整个过程中Claude 负责提问、规划、写文件你只负责回答和确认。阶段一 Discovery 发现先想清楚要造什么插件这一阶段的目标是把需求聊透。Claude 会问你 4 个关键问题这个插件要做什么解决什么问题谁会使用它在什么场景下使用需要对接哪些外部工具或服务有没有类似的插件或现成流程可以参考回答完毕后Claude 会复述它理解的插件目的与范围经你确认后才进入下一阶段——这避免了造出来的东西不是想要的。阶段二 Component Planning 组件规划确定插件里放什么基于上一阶段的答案Claude 会输出一张组件规划表明确做什么和不做什么组件数量用途Skills3领域知识、/执行操作、/检查操作MCP1连接外部服务Agents0不需要判断标准很简单需要专业知识或用户触发的操作→ 用 Skills需要读写外部系统数据库、SaaS 工具→ 用 MCP有自主多步任务→ 才考虑 Agents要事件自动拦截/校验→ 才考虑 Hooks你可以随时调整这张表确认后再继续。阶段三 Design 设计与澄清问题逐个敲定细节这是最容易含糊过关的阶段Claude 会针对每种组件分组提问把所有歧义消灭在动手之前Skills 相关用户说什么话时应该触发这个技能触发词要具体覆盖哪些知识领域要不要配references/参考文件MCP 相关用哪种服务器类型stdio本地进程/ SSE远程带 OAuth/ HTTPREST API认证方式是什么暴露哪些工具 小技巧如果你回答你看着办Claude 会给出具体的推荐方案并要求你明确确认——它不会擅自做主。阶段四 Implementation 实现按最佳实践生成全部文件确认后Claude 会按固定顺序动手创建插件目录结构编写plugin.json清单文件逐个创建各组件文件生成 README.md 文档几个关键的实现规范详见 component-schemas.md命名目录和文件一律用小写 连字符kebab-caseSKILL.md 渐进式披露正文控制在 3000 词以内细节内容放进references/目录按需加载技能正文是写给 Claude 的指令用祈使句解析该配置文件而非你应该解析路径可移植插件内部引用一律用${CLAUDE_PLUGIN_ROOT}绝不硬编码绝对路径plugin.json最小示例——最简只需要name字段{ name: meeting-notes, version: 0.1.0, description: Generate structured meeting notes from transcripts }三套不同复杂度的完整示例单技能 / 技能MCP / 全组件收录在 example-plugins.md可直接当模板。阶段五 Review 与 Package 审查打包交付可用的 .plugin 文件最后一步是验收和交付总结汇报列出每个组件及其用途询问你是否需要调整结构校验运行claude plugin validate命令检查结构若环境不支持则手动核对清单合法性、目录是否存在、每个技能子目录是否含SKILL.md打包交付将插件目录压缩为.plugin文件先写入/tmp/再复制到输出目录避免权限问题完成后.plugin文件会以富预览卡片出现在聊天窗口中——你可以浏览里面的每个文件点一下按钮即可安装 ✅写好 AI 工作插件的 5 条黄金法则#法则说明1从小处着手1 个打磨好的 Skill胜过 5 个半成品组件2渐进式披露核心知识放 SKILL.md细节放 references/示例放 examples/3触发词要具体描述里写用户真实会说的原话如 summarize this meeting4为 Claude 而写技能正文是操作指令不是给人看的文档5安全默认密钥走环境变量远程服务器用 HTTPS工具权限最小化进阶把官方插件改成你的公司版构建完自己的插件后不妨看看仓库里的 11 个官方插件销售、客服、法务、财务、数据等见 README.md。它们使用~~类别占位符如~~CRM、~~project tracker是工具无关的模板。配套的cowork-plugin-customizer技能SKILL.md可以自动帮你搜索公司内部知识库找出真实工具名 → 替换占位符 → 通过 MCP 注册表连接对应服务 → 重新打包。占位符替换后的效果可参考 sales/CONNECTORS.mdMCP 类别与搜索关键词的完整映射见 mcp-servers.md。核心文件速查 文件内容create-cowork-plugin/SKILL.md五阶段工作流的完整定义本教程的蓝本component-schemas.md四类组件的格式规范example-plugins.md3 个不同复杂度的完整示例插件cowork-plugin-customizer/SKILL.md定制现有插件的工作流mcp-servers.mdMCP 连接器发现与配置指南现在打开 Cowork说一句帮我创建一个插件你的专属 AI 工作助手五步之后就能上岗 【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考