# @atheory-ai/skillex 中文文档

规范地址：https://npmcn.com/package/%40atheory-ai/skillex/

版本：0\.11\.1
npm 元数据更新时间：2026-10-23T05:55:03.457Z
中文译文更新时间：2026-11-07T02:02:37.490Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40atheory-ai/skillex
原文对照：https://npmcn.com/package/%40atheory-ai/skillex/?lang=original
项目主页：https://github.com/atheory-ai/skillex#readme
源码仓库：https://github.com/atheory-ai/skillex

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

- 包体积（解压后）：13.6 kB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-04-07T05:56:02.225Z
- 最新版本发布：2026-10-23T05:55:03.055Z
- 近 30 天下载量：3530（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

在Node.js项目中对AI代理的技能培训

## 安装

```sh
npm install @atheory-ai/skillex
```

也可以使用：`pnpm add @atheory-ai/skillex`、`yarn add @atheory-ai/skillex`、`bun add @atheory-ai/skillex`

## README

# 技能

在多块块项目中对AI代理进行技能管理.

Skillex公司帮助代理商在不将整个Repo的文档倒入上下文的情况下,为他们正在研究的代码装入正确的指南. 它索引回波技能,软件包技能,包,范围规则,以及已安装的软件包版本,然后用微秒解答有针对性的询问.

## 斯克林克斯会做什么

-   决定文件路径、软件包、主题或标签的正确技能
-   处理同一软件包的多套版本
-   将公共消费者技能与私人维护者技能分开
-   从项目文件、依赖和探测器中激活装包技术
-   让软件包和Go模块飞船 `skillex/pack.yaml` 用他们的代码
-   通过 MCP 和 CLI 反向显示索引
-   能够实验性地发现和引用可信赖的下游MCP能力 无需在主办方单独登记
-   生成 `AGENTS.md` 用于不能直接使用 MCP 的代理的指令

## 建议安装

对于跨生态系统的使用,安装Skillex作为全球平台的通用功能. 见 通用安装器的主要项目README.

## 节点dev 依赖

当一个 Node.js 工程想要将 Skillex 绑定为本地 dev 时使用此 npm 软件包 工具设置 :

```bash
npm install --save-dev @atheory-ai/skillex
# or
pnpm add -D @atheory-ai/skillex
# or
yarn add -D @atheory-ai/skillex
```

GitHub Releases是犬科签名的二进制. 此软件包只包含一个 包装器,没有原生的有效载荷或平台依赖性. 邮购下载 sHA-256-核查档案 `v<package-version>`;运行时间重试,如果 安装已离线或脚本已禁用, 并验证已缓存的归档 在提取和执行新的二进制前.

要求节点.js 18+和 `tar` (ZIP能力 `tar` 包含在Windows 10+中). 支持macOS arm64/x64,Linux arm64/x64,和Windows x64. 下载需要 HTTPS 访问 GitHub 及其资产 CDN。 校验和校验不验证联合签名 签名.

设定 `SKILLEX_CACHE_DIR` 以覆盖默认值 `$XDG_CACHE_HOME/skillex` 或者说 `~/.cache/skillex` 存档缓存 . `SKILLEX_SKIP_DOWNLOAD=1` 只跳过张贴; 首先使用仍然获得释放. `SKILLEX_OFFLINE=1` 禁止下载和 需要有效的缓存。 在线温暖缓存或种子 `<cache>/<package-version>/<platform>-<arch>/` 与匹配的 cononical 归档 财务报告和审定财务报表 `checksums.txt`。缺失或腐败的离线档案显然失效。 书记官处 单是访问不足以进行第一次访问。 缓存的释放在清除 `node_modules`; 删除一个版本目录将其删除.

## MCP下游实验经纪人

Skillex 0.9.0包括明确选入下游的MCP能力中介. 主机只登记 Skillex; 启用的项目可以发现背景 MCP 并让 Skillex 引用选中的可信任服务器 。 现有 仅技能项目不变.

这个经纪人及其认证集成是实验性的. 协议 流动有自动化的合规覆盖,但互操作性未经认证 每个MCP服务器、身份提供者或企业部署。 见 [主要项目文件](https://github.com/atheory-ai/skillex#downstream-mcp-capability-broker) 用于配置、安全边界和当前支持矩阵.

## 快开始

在您的仓库中初始化 Skillex :

```bash
skillex init
```

重建本地技能指数:

```bash
skillex refresh
```

查询适用于文件的技能 :

```bash
skillex query --path packages/app-a/src/auth.ts
```

按主题、标签或包查询 :

```bash
skillex query --topic auth
skillex query --tags migration,breaking-change
skillex query --package @acme/foo
```

使用选定的结果只读取所需的指导:

```bash
skillex query --path packages/app-a/src/auth.ts --search "session handling"
skillex read --ref <ref-from-query> --section <optional-section-id>
```

`query` 返回已绑定的发现摘要。 阅读a/ 选中的技能或区域 . `--format content` 用于向后兼容, 但不是推荐的代理工作流程.

## 工作流程示例

1.  在其中添加回波技能 `skills/` 并配置区域 `skillex.json`
2.  运行 `skillex refresh` 更改后 `skills/`、配置、包或安装的依赖。 运行的 MCP 服务器更新已载入索引的项目技能目录, 例如 `.cursor/skills`,无需再刷新
3.  让您的代理查询, 缩小并只读取与其当前任务相关的技能

## 包装

包装是斯基克克斯的生态系统延伸机制. 包捆绑技能文件 有激活规则和可选探测器:

```text
skillex/
  pack.yaml
  usage.md
```

```yaml
name: my-framework
version: 1.0.0
detectors:
  my-framework:
    matches:
      - dependency:
          source: npm-package
          name: my-framework
skills:
  - file: usage.md
    activate-when:
      detector: my-framework
    scope: boundary
```

项目可以在当地进行包装,图书馆可以携带包装 软件包/模块源。 通过 `go.mod`当地 `replace`,以及 `vendor` 模块根; Skillex 不下载依赖性 在刷新或查询时.

## 为什么会这样

没有范围化的技能检索,代理商要么得到太少的上下文,要么得到太多的上下文. Skillex将范围分辨率移入确定索引,这样模型就可以接收当前路径和依赖边界的一小片正确指导.

## 仓库

-   资料来源: [https://github.com/atheory-ai/skillex 页面存档备份,存于互联网档案馆](https://github.com/atheory-ai/skillex)
-   联合国 [https://github.com/atheory-ai/skillex/blob/main/README.md 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/atheory-ai/skillex/blob/main/README.md)

## 常见问题

### @atheory-ai/skillex 是什么？

在Node\.js项目中对AI代理的技能培训

### 如何安装 @atheory-ai/skillex？

在项目目录运行 npm install @atheory-ai/skillex，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 skillex，可以用 npx skillex 直接运行。

### @atheory-ai/skillex 支持 TypeScript 吗？

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

### @atheory-ai/skillex 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @atheory-ai/skillex 可以商用吗？

@atheory-ai/skillex 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @atheory-ai/skillex 的下载量有多少？

根据 npm 官方下载统计，@atheory-ai/skillex 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,530 次，日均约 118 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @atheory-ai/skillex 还在维护吗？

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