# @framers/agentos-skills 中文文档

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

版本：0\.10\.4
npm 元数据更新时间：2026-10-31T18:26:14.789Z
中文译文更新时间：2026-11-15T12:03:03.683Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：466 kB，98 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-02-07T17:04:48.522Z
- 最新版本发布：2026-10-31T18:26:14.461Z
- 近 30 天下载量：22146（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

Curfied SKILL.md 为AgentOS提供的即时模块——机器可读技能的注册,即时,再用代理能力. 与 @ framers/ agentos TypeScript AI 代理运行时同步 .

## 安装

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

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

## README

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

# @ framers/ 代理技能

**用于 AgentOS 的已校验 SKILL.md 提示模块** 88名工作人员通过机器可读登记册索引核查的技能.

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

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

> **这是内容包.** 里面有88个编译的SKILL.md档案和 生成 `registry.json` 指数,没有依赖关系。 它的运行时间代码是 `index.mjs`,其内容如下: `registry.json` 并出口出来.
> 
> 给 **目录 SDK** (清仓助工,懒散装卸,工厂功能),参见: [`@framers/agentos-skills-registry`](https://github.com/framerslab/agentos-skills-registry)。 。 。 .
> 
> 给 **运行时引擎** (SkillLoader、SkillRegistry、路径公用事业),见 [`@framers/agentos`](https://github.com/framerslab/agentos) (单位:千美元)`@framers/agentos/cognition/skills`,也可以从包根再出.

## 里面的东西

此软件包捆绑 **88个整理的SKILL.md文件** 下级 `registry/curated/`: 82 在自己的目录和6个游戏技能下 `registry/curated/game/`。 。 。 . `registry.json` 给予其中每个类别:

| 类别 | 技能 |
| --- | --- |
| 自动化 | `account-manager`, (中文(简体) ), `web-scraper` |
| 商业 | `company-research` |
| 云门 | `cloud-deployment` |
| 通讯 | `channel-management`, (中文(简体) ), `discord-helper`, (中文(简体) ), `slack-helper`, (中文(简体) ), `voice-conversation` |
| 内容 | `content-creator` |
| 创意 | `image-gen` |
| 开发者 | `github` |
| 开发工具 | `coding-agent`, (中文(简体) ), `git` |
| 调试 | `healthcheck` |
| 娱乐 | `movie-lookup` |
| 游戏 | `game/combat-balancer`, (中文(简体) ), `game/companion-writer`, (中文(简体) ), `game/encounter-judge`, (中文(简体) ), `game/narrator`, (中文(简体) ), `game/quest-designer`, (中文(简体) ), `game/world-builder` |
| 资料 | `summarize`, (中文(简体) ), `weather`, (中文(简体) ), `web-search` |
| 基础设施 | `cloud-ops`, (中文(简体) ), `site-deploy` |
| 营销 | `seo-campaign` |
| 媒体 | `audio-generation`, (中文(简体) ), `media-discovery`, (中文(简体) ), `spotify-player`, (中文(简体) ), `video-generation`, (中文(简体) ), `whisper-transcribe` |
| 生产率 | `apple-notes`, (中文(简体) ), `apple-reminders`, (中文(简体) ), `document-export`, (中文(简体) ), `emergent-tools`, (中文(简体) ), `interactive-widgets`, (中文(简体) ), `memory-manager`, (中文(简体) ), `multimodal-rag`, (中文(简体) ), `notion`, (中文(简体) ), `obsidian`, (中文(简体) ), `productivity-suite`, (中文(简体) ), `trello` |
| 研究 | `deep-research`, (中文(简体) ), `fact-grounding`, (中文(简体) ), `research-tools` |
| 保险 | `hitl-safety` |
| 警卫 | `1password`, (中文(简体) ), `code-safety`, (中文(简体) ), `grounding-guard`, (中文(简体) ), `ml-content-classifier`, (中文(简体) ), `pii-redaction`, (中文(简体) ), `topicality` |
| 社会自主 | `blog-publisher`, (中文(简体) ), `bluesky-bot`, (中文(简体) ), `facebook-bot`, (中文(简体) ), `instagram-bot`, (中文(简体) ), `linkedin-bot`, (中文(简体) ), `mastodon-bot`, (中文(简体) ), `pinterest-bot`, (中文(简体) ), `reddit-bot`, (中文(简体) ), `social-automation`, (中文(简体) ), `threads-bot`, (中文(简体) ), `tiktok-bot`, (中文(简体) ), `twitter-bot`, (中文(简体) ), `youtube-bot` |
| 系统 | `cli-tools`, (中文(简体) ), `system-tools` |
| 未分类 | `agent-config`, (中文(简体) ), `email-intelligence`, (中文(简体) ), `image-editing`, (中文(简体) ), `social-broadcast`, (中文(简体) ), `structured-output` |
| 愿景 | `vision-ocr` |
| 语音 | `amazon-polly`, (中文(简体) ), `diarization`, (中文(简体) ), `endpoint-semantic`, (中文(简体) ), `google-cloud-stt`, (中文(简体) ), `google-cloud-tts`, (中文(简体) ), `openwakeword`, (中文(简体) ), `piper`, (中文(简体) ), `porcupine`, (中文(简体) ), `streaming-stt-deepgram`, (中文(简体) ), `streaming-stt-whisper`, (中文(简体) ), `streaming-tts-elevenlabs`, (中文(简体) ), `streaming-tts-openai`, (中文(简体) ), `voice-telephony`, (中文(简体) ), `vosk` |

每个技能都是带有 YAML 前题的 Markdown 文件 :

```yaml
---
name: github
version: '2.0.0'
description: Full GitHub API integration — 26 tools for repos, issues, PRs, branches, commits, releases, Actions, files, gists, and codebase indexing.
author: Wunderland
namespace: wunderland
category: developer
tags: [github, git, repository, issues, pull-requests, code-review, ci-cd, releases, actions, api]
requires_secrets: [github.token]
requires_tools: [github_search, github_repo_list, github_repo_info, ...]
metadata:
  agentos:
    emoji: "\U0001F4BB"
---

# GitHub

[Markdown instructions for the agent...]
```

这是 `github` 技能的前题 `requires_tools` 剪短时间。 下 `metadata.agentos`,一个技能也可以设置 `primaryEnv`, (中文(简体) ), `os`, (中文(简体) ), `requires` (单位:千美元)`bins`, (中文(简体) ), `anyBins`, (中文(简体) ), `env`, (中文(简体) ), `config`和 `install` 步骤; 运行时引擎检查 `requires` 当一个快照用 `strict: true`。 。 。 .

## 生态系统

```
@framers/agentos/cognition/skills     ← Engine (SkillLoader, SkillRegistry, path utils)
@framers/agentos-skills               ← Content (you are here — 88 SKILL.md files + registry.json)
@framers/agentos-skills-registry      ← Catalog SDK (SKILLS_CATALOG, query helpers, factories)
```

| 软件包 | 作用 | 什麽 | 运行时代码 |
| --- | --- | --- | :-: |
| [**@ 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), (中文(简体) ), [路径曲线](https://github.com/framerslab/agentos/blob/master/src/cognition/skills/paths.ts) | 对 |
| [**@ 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) 指数 | `index.mjs` 仅限 |
| [**@ framers/ agentos- 技能- 注册**](https://github.com/framerslab/agentos-skills-registry) | **目录SDK** | SKILLLS CATALOG, 查询助手, 懒惰的加载者, 工厂 | 对 |

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

## 使用量

### 登记册索引

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

console.log(`${registry.stats.totalSkills} skills available`);
for (const skill of registry.skills.curated) {
  console.log(`  ${skill.metadata?.emoji ?? '📦'} ${skill.name} — ${skill.description}`);
}
```

默认导出为解析 `registry.json`。导入 `@framers/agentos-skills/registry.json` 直接需要 JSON 导入属性(`with { type: 'json' }`) 在节点上.

### 通过目录SDK(建议)

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

const matches = searchSkills('github');
const skill = await loadSkillByName('github');
console.log(skill?.content); // SKILL.md body ready for prompt injection
```

### 通过运行时引擎

```typescript
import { SkillRegistry } from '@framers/agentos/cognition/skills';

const registry = new SkillRegistry();
await registry.loadFromDirs([
  '/path/to/agentos-skills/registry/curated',
  '/path/to/agentos-skills/registry/curated/game',
]);
const snapshot = registry.buildSnapshot({ platform: 'darwin', strict: true });
console.log(snapshot.prompt);
```

`loadFromDirs()` 读取 `SKILL.md` 每个目录直接放在列表下,所以游戏技能需要 `registry/curated/game` 名单也列出.

## 捐款

见 [捐款额](https://github.com/framerslab/agentos-skills/blob/master/CONTRIBUTING.md) 关于增加新技能的准则.

## 许可证

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

* * *

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

由 [框架](https://frame.dev/)  
联系人 : [团队@frame.dev](mailto:team@frame.dev)

## 常见问题

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

Curfied SKILL\.md 为AgentOS提供的即时模块——机器可读技能的注册,即时,再用代理能力\. 与 @ framers/ agentos TypeScript AI 代理运行时同步 \.

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

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

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

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

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

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

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

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

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

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

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

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