使用插件 / 构建插件

安装已发布的插件，或准备可移植的 Agent Plugins 1.0 包。

使用插件

现已可用：通过 Universal Agent Plugins 安装插件。使用 Node.js 22+ 时运行：

npx universal-agent-plugins add context7

如需在 macOS、Linux 或 Windows 上进行原生安装，请阅读安装指南。CLI 会询问要使用哪些兼容的客户端；个别插件可能需要自己的运行环境。

安装指南

版本核验日期为 2026-09-07：universal-agent-plugins 0.1.53（npm）、plugin-kit-ai 1.2.4（npm/PyPI），GitHub 稳定版本 agentplugins-v0.1.53。

兼容性取决于包。通过模式验证并不证明运行、OAuth 或激活成功。Codex 不支持声明的 MCP SSE；stdio 和 Streamable HTTP 保留现有适配器支持。

客户端兼容性（英文）

构建插件

以 plugin.json 为核心构建可移植的 Agent Plugins 1.0 包，可选包含 skills/ 和 mcp.json。客户端支持取决于包及其组件。

准备中 — 尚未发布

以标准为先的创作 CLI 正在准备中，尚未发布。npm 和 PyPI 上已发布的 plugin-kit-ai 1.2.4 是历史 v1 工具，并非 standard-first v2。安装 plugin-kit-ai@latest 不会提供未来的创作流程。

Agent Plugins 1.0 规范

历史 v1 维护

请使用以下 v1 说明维护现有 plugin.yaml 项目。这些模板和生成输出属于历史 v1 流程，不会创建新的标准优先创作流程。

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version
plugin-kit-ai init my-plugin
cd my-plugin
go mod tidy
plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict

你得到什么

• 从第一天起就有一个插件仓库
• 新仓库在 plugin/ 下创作文件
• 从同一存储库生成 Codex 运行时输出
• 通过 validate --strict 进行干净的准备检查

支持 Node 和 Python 路径

如果您的团队已位于 Node/TypeScript 或 Python 中，则这些路径从一开始就受支持且可见：

• codex-runtime --runtime node --typescript
• codex-runtime --runtime python
• 两者都是本地解释运行时路径，因此目标机器仍然需要 Node.js 20+ 或 Python 3.10+
• 当您想要最强的一般制作故事时，Go 仍然保持默认值

如果您有意从 Node 或 Python 开始

仅当语言选择已是产品要求的一部分时才使用此替代流程：

plugin-kit-ai init my-plugin --platform codex-runtime --runtime node --typescript
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

或者以 Python 开头：

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

接下来做什么

• 编辑 plugin/ 下的插件
• 更改后再次运行 plugin-kit-ai generate ./my-plugin
• 再次运行 plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict
• 只有在产品需要时才添加另一种运输方式

稍后展开

如果你想要	稍后添加
Claude 与真实产品挂钩	claude
官方Codex包	codex-package
Gemini 扩展包	gemini
回购拥有的集成设置	opencode 或 cursor

仅当 Claude 挂钩已经是实际产品需求时，才首先选择 claude。

稍后扩展的内容

• 当您添加更多通道时，存储库保持统一
• 包和扩展通道来自同一来源
• 当存储库应该拥有集成设置时，OpenCode 和 Cursor 适合
• 确切的支持边界保留在参考文档中，而不是在您的首次启动流程中

快速入门后

• 历史 v1 教程：构建您的第一个插件。
• 如果您想要完整的产品地图，请继续您可以构建什么。
• 当您准备好将存储库与您想要的运输方式相匹配时，继续选择目标。
• 当您准备好扩展第一条路径之外时，继续一个项目，多个目标。