# @arcjet/skills 中文文档

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

版本：1\.15\.0
npm 元数据更新时间：2026-10-28T18:46:28.967Z
中文译文更新时间：2026-11-06T14:45:40.292Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：60.3 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.21\.0 \<23 \|\| \>=24\.5\.0
- 运行依赖：0 个
- 首次发布：2026-09-08T17:21:39.564Z
- 最新版本发布：2026-10-28T18:46:27.385Z
- 近 30 天下载量：112512（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

Arcjet JavaScript SDK 的版本代理技能, 与 TanStack Intent 一起运出

## 安装

```sh
npm install @arcjet/skills
```

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

## README

[![Arcjet Logo](https://arcjet.com/logo/arcjet-light-lockup-voyage-horizontal.svg)](https://arcjet.com/)

# `@arcjet/skills`

[![npm badge](https://img.shields.io/npm/v/%40arcjet%2Fskills?style=flat-square&label=%E2%9C%A6Aj&labelColor=ECE6F0&color=ECE6F0)](https://www.npmjs.com/package/@arcjet/skills)

已版本 [代理技能](https://agentskills.io/) 用于Arcjet JavaScript SDK, 运出 [TanStack 意图](https://tanstack.com/intent)。 。 。 .

-   [npm 软件包 (`@arcjet/skills`(中文(简体) )](https://www.npmjs.com/package/@arcjet/skills)
-   [GitHub 源代码 (`arcjet-skills/` 内 `arcjet/arcjet-js`(中文(简体) )](https://github.com/arcjet/arcjet-js/tree/main/arcjet-skills)

技能旅行与已安装的软件包版本. 他们不是复制品 规则文件,他们不是模型的训练截止.

独立市场安装`npx skills add arcjet/skills`还是 作品来自 [`arcjet/skills`](https://github.com/arcjet/skills). 更喜欢这个 软件包,当您需要符合 SDK 版本的技能时 `node_modules`。 。 。 .

## 这是什么?

发布 :

-   `skills/*/SKILL.md` ——代理指导,每项任务1个技能
-   `docs/*.md` 原始文献记载这些技能来自
-   细打的明细表(`skills`, (中文(简体) ), `skillIdentity`用于已运出叶名

TanStack 意图发现 `SKILL.md` 文件为静态文件。 没有 导入或执行此软件包(或任何其他软件包)以找到它们.

## 安装

这套方案只是无害环境管理.

```sh
npm install @arcjet/skills
```

依赖于 `arcjet` 同时安装此软件包 转来转去,所以典型的 `@arcjet/next` 应用程序已经在磁盘上有文件 .

警卫一体化技能船 [`@arcjet/guard`](https://npmcn.com/package/%40arcjet/arcjet-guard/README.md) 旁边的包的读取。 使用 Guard 时, 允许两个软件包 .

## 与 TanStack 意图使用

已安装的自定义扫描 `skills/**/SKILL.md`发现是 不信任他们。 在 **应用程序** `package.json`数字 :

```json
{
  "intent": {
    "skills": ["@arcjet/skills", "@arcjet/guard"],
    "exclude": []
  }
}
```

`intent.skills` 许可证包,而不是个人技能。 使用 `intent.exclude` 放弃一个软件包或一个技能(`@arcjet/guard#integrate-arcjet-guard-eve`) (中文(简体) ).

省略一个 `intent.skills` 密钥当前显示每个已发现的软件包 并打印一份贬值通知。 不使用 `"skills": ["*"]` 除非你们 接受整个树上未经审查的技能.

```sh
npx @tanstack/intent@latest install
npx @tanstack/intent@latest list
npx @tanstack/intent@latest load @arcjet/skills#protect
```

`install` 将加载指南写入 `AGENTS.md` (或现有代理人) conf. `list` 显示许可列表允许的内容 . `load` 打印一个 `SKILL.md` ——只装入当前任务所需的技能.

| 任务 | 装入 |
| --- | --- |
| HTTP 路由、 API 、 中间软件 | `@arcjet/skills#protect` |
| 适用哪些规则 | `@arcjet/skills#choose-protections` |
| 签名和写入 `ARCJET_KEY` | `@arcjet/skills#cli` |
| MCP 服务器设置 | `@arcjet/skills#mcp` |
| 工具呼叫、 MCP 处理器、 工作 | `@arcjet/skills#guard` |
| 一个特别的警卫供应商SDK | `@arcjet/guard#integrate-arcjet-guard-*` |

### 信任模式

-   意向读取包元数据和技能文件. 它不执行软件包 用于发现或加载技能的代码.
-   许可和排除是信托决定.
-   `intent load` 返回内容是指在当前情况下解决的文件 政策。 这并不意味着技能是相关的,也不意味着该模式是遵循的 这个.
-   `npx @tanstack/intent@latest hooks install` 可添加会话目录和 为一些代理编辑出关 。 把钩子当作方便,不是 安全边界。 他们可以观察负载命令;他们无法证明 特工使用了指导.

## 已打入清单

```ts
import {
  PACKAGE_NAME,
  VERSION,
  getSkill,
  skillIdentity,
  skills,
} from "@arcjet/skills";

skillIdentity("protect"); // "@arcjet/skills#protect"
getSkill("cli")?.file; // "skills/cli/SKILL.md"
```

此列表仅用于此软件包 。 它不扫描其他依赖.

## 维护者

技能文件在它们来自的文档旁边存在(`docs/` 在此 软件包; `README.md` 页:1 `@arcjet/guard` 技术)。 每个 `SKILL.md` 声明 这些路径在 `sources`。 。 。 .

```sh
npx @tanstack/intent@latest validate
npx @tanstack/intent@latest stale --json
```

`validate` cI要求这样做. `stale` 保守: 更改的源是一个 复议信号,而不是证明技能是错误的。 CI 失败的拉动请求 已声明源更改和匹配 `SKILL.md` 没有.

这个 `tanstack-intent` 关键词和 `skills/` `files` 输入 将技能 在 npm 沥青球 中, 这样注册可以索引它们 .

## 许可证

[Apache 许可证,2.0版本](http://www.apache.org/licenses/LICENSE-2.0) © [Arcjet实验室股份有限公司.](https://arcjet.com/)

## 常见问题

### @arcjet/skills 是什么？

Arcjet JavaScript SDK 的版本代理技能, 与 TanStack Intent 一起运出

### 如何安装 @arcjet/skills？

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

### @arcjet/skills 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @arcjet/skills 支持 ESM 还是 CommonJS？

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

### @arcjet/skills 需要什么版本的 Node\.js？

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

### @arcjet/skills 可以商用吗？

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

### @arcjet/skills 的下载量有多少？

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

### @arcjet/skills 还在维护吗？

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