# @vention/vention-skills 中文文档

规范地址：https://npmcn.com/package/%40vention/vention-skills/

版本：0\.10\.31
npm 元数据更新时间：2026-11-02T19:46:36.220Z
中文译文更新时间：2026-11-02T19:55:54.967Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40vention/vention-skills
原文对照：https://npmcn.com/package/%40vention/vention-skills/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：187 kB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-05T17:58:04.561Z
- 最新版本发布：2026-11-02T19:46:36.045Z
- 已发布版本数：83（近 12 个月 83 个）

## 中文简介

编码代理的技巧：编写MachineLogic应用程序，构建机器设计，诊断部署的机器。

## 安装

```sh
npm install @vention/vention-skills
```

也可以使用：`pnpm add @vention/vention-skills`、`yarn add @vention/vention-skills`、`bun add @vention/vention-skills`

## README

# Vention技能

0.10.31版本。与Vention机器一起工作的编码代理的技能，打包成一个插件， `vention`，在… `vention-skills` 市场。

| 技能 | 它是做什么的 |
| --- | --- |
| `vention-machine-logic` | 类编写、验证和部署MachineLogic Python应用程序 `machine-logic-sdk` 和ventioncli。 |
| `vention-machine-logic-hmi` | 在通过协议通信连接的Vention组件库上构建MachineLogic应用程序的自定义操作员HMI。 |
| `vention-design` | 通过Vention MCP服务器创建和编辑Vention机器的设计图和设计图。 |
| `vention-monitoring` | 通过Vention MCP服务器从控制器状态、历史记录、运行状况和活动数据诊断已部署的计算机。 |

## 安装

该插件作为npm包发布 `@vention/vention-skills`，列于 `vention-skills` 目录在 `https://assets.vention.com/vention-skills/marketplace.json`.

Claude Code需要2.1.277或更高版本：早期版本运行插件包的安装脚本。

在任何客户端上最快的路径是Vention CLI：

```bash
npm install -g @vention/vention-cli
vention skills install
```

在Windows上，如果 `vention` 安装后是不是找不到文件夹了 `npm prefix -g` 打印到您的PATH并打开一个新的终端，或者运行 `npx -y @vention/vention-cli skills install` 代替。

| 客户端 | 什么 `vention skills install` 运行 |
| --- | --- |
| 克劳德代码 | `claude plugin marketplace add --scope <scope> <catalog URL>`,然后 `claude plugin install -y --scope <scope> vention@vention-skills`. |
| 食典委 | 始终为您的用户帐户安装（Codex没有项目范围）。在主目录下写入一个包含相同npm条目的目录目录，然后运行 `codex plugin marketplace add <dir>` 和 `codex plugin add vention@vention-skills`. |
| 游标,副驾驶 | `npm pack @vention/vention-skills`，然后打开包中包含的所有技能 `.agents/skills` 在您的主目录或项目(每 `--scope`)，取代这些技能，其余的保持不变。 |
| 手册 | `npm pack @vention/vention-skills`，然后复制 `package/skills/<skill>` 进入代理的技能目录。 |

`vention skills status` 列出磁盘上的每个Vention技能及其版本，旁边是npm上的最新版本。 `vention skills update` 更新所有有技能的特工，克劳德代码通过 `claude plugin update vention@vention-skills`，通过重新运行其安装，并通过在安装它们的作用域再次打开光标和副驾驶包。这个 `vention-machine-logic` 和 `vention-machine-logic-hmi` 技能在每个会话开始时运行此检查。

## 验证安装

在添加HMI技能之前，根据发布到一次性本地注册表的0.1.0包手工检查。

| 客户端 | 版本 | 状态 |
| --- | --- | --- |
| 克劳德代码 | 2.1.267 | 未经验证：测试机器的托管Claude Code策略只允许列出的市场，因此它拒绝了本地目录URL |
| 食典委 | codex-cli 0.157.1 | 已安装和已加载：NPM包被加载到 `plugins/cache/vention-skills/vention/0.1.0/skills/<skill>/SKILL.md` 这三种技能都出现在提示文本呈现中 |
| 光标 | 3.22.7 | 安装在 `.agents/skills`； 未检查客户端加载 |
| 副驾驶员 | VS代码1.114.0，副驾驶聊天0.42.3 | 安装在 `.agents/skills`； 未检查客户端加载 |
| 手册 | npm 11.6.1 | 文件安装: `npm pack` 再加上一个副本 `.claude/skills` |

## 开发

每一个变化都要经过 `vention-skills` 项目 `VentionCo/platform-products` （`projects/machine-code/libs/vention-skills`）。

-   `npx nx build vention-skills` 将包写入 `dist/projects/machine-code/libs/vention-skills/`，将包版本戳入插件清单和每个 `SKILL.md`。这个目录是npm包的根目录和插件的根目录。
-   `npx nx test vention-skills` 首先构建，然后检查前端内容，每个技能提到的相对路径， `claude plugin validate --strict`，从构建包进行安装，并对示例进行访问。
-   `npx nx lint vention-skills` 检查构建和测试源。

### 释放

`nx release` 读最新的 `vention-skills@<version>` 标记，从常规提交中计算出下一个版本，标记它，创建GitHub发布，然后发布 `dist/{projectRoot}` 通过NPM `nx-release-publish` 默认目标。npm通过包的GitHub信任发布者对发布作业进行身份验证，因此不会存储npm令牌。

提交文件中的版本 `package.json` 仅仅是一个起点：发布运行在构建之前将新版本写入那里，并且从不提交它。

市场文件从Vention CDN提供，而不是从npm提供。这个 `publish` 目标上传提交的文件 `.claude-plugin/marketplace.json` 到 `vention-skills` 在涉及此项目的每个主构建上。然后Watchtower将上传的内容固定在devops仓库中，并通过上面的URL进行产品推广。

## 常见问题

### @vention/vention-skills 是什么？

编码代理的技巧：编写MachineLogic应用程序，构建机器设计，诊断部署的机器。

### 如何安装 @vention/vention-skills？

在项目目录运行 npm install @vention/vention-skills，或使用 pnpm add / yarn add / bun add。

### @vention/vention-skills 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/vention\_\_vention-skills 是否存在。

### @vention/vention-skills 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @vention/vention-skills 可以商用吗？

@vention/vention-skills 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @vention/vention-skills 还在维护吗？

最新版本 0\.10\.31 发布于 2026/11/03（今天）；至今共发布 83 个版本，其中过去 12 个月发布了 83 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。