@atheory-ai/skillex

中文文档
0.11.1发布于 2026/10/23Apache-2.0零依赖构建来源已验证近 30 天下载 3530

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

中文使用文档
文档目录9 节
  1. 斯克林克斯会做什么
  2. 建议安装
  3. 节点dev 依赖
  4. MCP下游实验经纪人
  5. 快开始
  6. 工作流程示例
  7. 包装
  8. 为什么会这样
  9. 仓库

技能

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

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

斯克林克斯会做什么

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

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

节点dev 依赖

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

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服务器、身份提供者或企业部署。 见 主要项目文件 用于配置、安全边界和当前支持矩阵.

快开始

在您的仓库中初始化 Skillex :

skillex init

重建本地技能指数:

skillex refresh

查询适用于文件的技能 :

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

按主题、标签或包查询 :

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

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

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. 让您的代理查询, 缩小并只读取与其当前任务相关的技能

包装

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

skillex/
  pack.yaml
  usage.md
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将范围分辨率移入确定索引,这样模型就可以接收当前路径和依赖边界的一小片正确指导.

仓库

版本与发布记录

@atheory-ai/skillex 共发布 12 个版本,首次发布于 2026/04/07;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.1latest2026/10/2315 天前
0.11.02026/10/1721 天前
0.10.02026/10/031 个月前
0.9.12026/09/301 个月前
0.9.02026/09/151 个月前
0.8.32026/07/313 个月前

关于 @atheory-ai/skillex 的常见问题

@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 和提交记录判断。