# @framers/agentos-skills-registry 中文文档

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

版本：0\.19\.11
npm 元数据更新时间：2026-11-14T10:24:14.921Z
中文译文更新时间：2026-11-15T13:45:14.481Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：110 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@framers/agentos \>=0\.10\.34
- 首次发布：2026-02-07T17:05:47.363Z
- 最新版本发布：2026-11-14T10:24:14.595Z
- 近 30 天下载量：3369（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

AgentOS技能的Catalog SDK – 查询助手,懒惰加载者,以及被曲解的SKILL.md快取模块的工厂功能. 与 @ framers/ agentos TypeScript AI 代理运行时同步 .

## 安装

```sh
npm install @framers/agentos-skills-registry
```

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

## README

[![AgentOS](https://npmcn.com/package/%40framers/agentos-skills-registry/logos/agentos-primary-no-tagline-transparent-2x.png)](https://agentos.sh/)     [![Frame.dev](https://npmcn.com/package/%40framers/agentos-skills-registry/logos/frame-logo-green-no-tagline.svg)](https://frame.dev/)

# @ framers/ agentos- 技能- 注册

**目录SDK** 用于查询和装入 AgentOS 技能.

[![npm](https://img.shields.io/npm/v/@framers/agentos-skills-registry?logo=npm&color=cb3837)](https://www.npmjs.com/package/@framers/agentos-skills-registry)

```bash
npm install @framers/agentos-skills-registry
```

给 **技能内容** (SKILL.MD文件),见 [`@framers/agentos-skills`](https://github.com/framerslab/agentos-skills)。 。 。 .

## 生态系统

| 软件包 | 作用 |
| --- | --- |
| [`@framers/agentos-skills`](https://github.com/framerslab/agentos-skills) | 内容 - 88 [SKILL.md 文件 存档](https://github.com/framerslab/agentos-skills/tree/master/registry/curated) + 键 [登记册.json](https://github.com/framerslab/agentos-skills/blob/master/registry.json) |
| [`@framers/agentos-skills-registry`](https://github.com/framerslab/agentos-skills-registry) | Catalog SDK — 查询助手,懒惰的加载者,工厂 |
| [`@framers/agentos`](https://github.com/framerslab/agentos/tree/master/src/cognition/skills) | 发动机 - [技能记录器](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/SkillLoader.ts), (中文(简体) ), [技能登记](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/SkillRegistry.ts),技能图 |

> 此布局映射扩展生态系统 : [`@framers/agentos-extensions`](https://github.com/framerslab/agentos-extensions) (内容)+ [`@framers/agentos-extensions-registry`](https://github.com/framerslab/agentos-extensions-registry) (SDK) (英语).

| 软件包 | 作用 | 什麽 | 运行时代码 | 依赖关系 |
| --- | --- | --- | :-: | --- |
| [**@ fraders/ agentos/ 技能**](https://github.com/framerslab/agentos/tree/master/src/cognition/skills) | **发动机** | [技能记录器](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/SkillLoader.ts), (中文(简体) ), [技能登记](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/SkillRegistry.ts), (中文(简体) ), [路径曲线](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/paths.ts) | 对 | `yaml` |
| [**@ framers/ 代理技能**](https://github.com/framerslab/agentos-skills) | **内容** | 88国道 [SKILL.md 文件 存档](https://github.com/framerslab/agentos-skills/tree/master/registry/curated) + 键 [登记册.json](https://github.com/framerslab/agentos-skills/blob/master/registry.json) 指数 | 没有 | 无 |
| [**@ framers/ agentos- 技能- 注册**](https://github.com/framerslab/agentos-skills-registry) | **目录SDK** | SKILLLS CATALOG, 查询助手, 懒惰的加载者, 工厂 | 对 | `agentos-skills`, (中文(简体) ), `yaml` |

## 快速启动

### 1\. 浏览目录( 0 对等分解)

```typescript
import {
  SKILLS_CATALOG,
  searchSkills,
  getSkillsByCategory,
  getSkillByName,
} from '@framers/agentos-skills-registry/catalog';

// Full-text search
const matches = searchSkills('github');
console.log(matches.map((s) => `${s.name}: ${s.description}`));

// By category
const devSkills = getSkillsByCategory('developer');
console.log(`${devSkills.length} developer skills`);

// By name
const gh = getSkillByName('github');
console.log(gh?.requiredSecrets); // ['github.token']
```

### 2\. 随需要装入懒惰技能

```typescript
import { loadSkillByName } from '@framers/agentos-skills-registry';

const skill = await loadSkillByName('github');
if (skill) {
  console.log(skill.content); // SKILL.md body for prompt injection
  console.log(skill.metadata?.emoji); // "octopus"
}
```

### 3\. 制作技能短片( 需要@ framers/ agentos)

```typescript
import { createCuratedSkillSnapshot } from '@framers/agentos-skills-registry';

const snapshot = await createCuratedSkillSnapshot({
  skills: ['github', 'web-search', 'notion'],
  platform: 'darwin',
});

// Inject into agent prompt
console.log(snapshot.prompt);
```

### 4\. 工作空间技能的发现

```typescript
import {
  discoverWorkspaceSkills,
  mergeWithWorkspaceSkills,
  SKILLS_CATALOG,
} from '@framers/agentos-skills-registry';

// Scan .agents/skills/ for workspace-local skills
const workspace = await discoverWorkspaceSkills();

// Merge with curated (workspace takes priority on name collision)
const merged = mergeWithWorkspaceSkills(SKILLS_CATALOG, workspace);
```

发现不跟随技能文件夹下方的符号链接. 一个技能文件夹或作为链接的SKILL.md,或者不是普通文件的SKILL.md,都会被一个警告跳过,每个发现的技能的 `loadSkill()` 读它的文件的方式相同.

## 分出口

| 入口 | 什麽 | 端点 |
| --- | --- | --- |
| `@framers/agentos-skills-registry` | 完整的API:目录+工厂+工作空间发现 | `@framers/agentos` (可选) |
| `@framers/agentos-skills-registry/catalog` | `SKILLS_CATALOG`,查询助手,懒惰加载者 | 无 |
| `@framers/agentos-skills-registry/workspace-discovery` | 工作空间技能扫描+合并 | 无 |

## API 参考

### 目录查询

-   `SKILLS_CATALOG` -- 排序了所有编程 + 社区技能条目
-   `searchSkills(query)` - 在姓名、说明和标签之间进行全文搜索
-   `getSkillsByCategory(category)` -- 按类别过滤
-   `getSkillByName(name)` - 单一技能查询
-   `getAvailableSkills(installedTools)` -- 通过可用工具过滤
-   `getCategories()` -- 列出唯一类别
-   `getSkillsByTag(tag)` -- 通过标签过滤
-   `getCuratedSkills()` 编号 : `getCommunitySkills()` 编号 : `getAllSkills()` -- 源过滤器
-   `getSkillEntries(names)` -- 按名称列表过滤( E)`'all'` | `'none'` | `string[]`(中文(简体) )

### 懒惰装入

-   `loadSkillByName(name)` -- 装入并解析单个 SKILL. md 名称
-   `loadSkillsByNames(names)` - 平行加载多种技能
-   `createLocalSkillProxy(relativePath, displayName)` - 懒装工厂

### 工厂功能( 需要@ framers/ agentos)

-   `createCuratedSkillRegistry(options?)` - 创建现场 `SkillRegistry` 具备特定技能
-   `createCuratedSkillSnapshot(options?)` - 建立一个 `SkillSnapshot` 准备迅速注射

### 路径助手

-   `getBundledCuratedSkillsDir()` -- 绝对路径 `@framers/agentos-skills/registry/curated/`
-   `getBundledCommunitySkillsDir()` -- 绝对路径 `@framers/agentos-skills/registry/community/`

### 工作空间发现

-   `discoverWorkspaceSkills(options?)` -- -- 扫描 `.agents/skills/` 工作空间-当地技能,不遵循下面的象征性链接
-   `mergeWithWorkspaceSkills(registry, workspace)` - 与优先级合并到工作空间
-   `parseSkillFrontmatter(content)` 从技能内容中解析 YAML 前题

## 捐助和支助

| 指南 | 什麽 |
| --- | --- |
| [捐款](https://github.com/framerslab/agentos-skills-registry/blob/master/CONTRIBUTING.md) | 制定、承诺和拉动请求规则、审查线索、发放捐款许可证 |
| [发行指南](https://github.com/framerslab/agentos-skills-registry/blob/master/RELEASING.md) | 每日发行(10:17 UTC)如何公布合并后npm的更改,现在如何发行 |
| [代理指令](https://github.com/framerslab/agentos-skills-registry/blob/master/AGENTS.md) | 编码代理人的命令和公约 |
| [行为守则](https://github.com/framerslab/agentos-skills-registry/blob/master/.github/CODE_OF_CONDUCT.md) | 社区标准 |
| [安全政策](https://github.com/framerslab/agentos-skills-registry/blob/master/.github/SECURITY.md) | 私下报告脆弱性 |
| [支助](https://github.com/framerslab/agentos-skills-registry/blob/master/SUPPORT.md) | 哪里去寻求帮助 |

## 许可证

Apache 2.0 — 见 [自由主义](https://github.com/framerslab/agentos-skills-registry/blob/master/LICENSE)。 。 。 .

## 常见问题

### @framers/agentos-skills-registry 是什么？

AgentOS技能的Catalog SDK – 查询助手,懒惰加载者,以及被曲解的SKILL\.md快取模块的工厂功能\. 与 @ framers/ agentos TypeScript AI 代理运行时同步 \.

### 如何安装 @framers/agentos-skills-registry？

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

### @framers/agentos-skills-registry 支持 TypeScript 吗？

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

### @framers/agentos-skills-registry 支持 ESM 还是 CommonJS？

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

### @framers/agentos-skills-registry 可以商用吗？

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

### @framers/agentos-skills-registry 的下载量有多少？

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

### @framers/agentos-skills-registry 还在维护吗？

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