> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能

> 在你的AI编码代理中安装和管理Olostep技能

从命令行直接将Olostep技能文件夹安装到你的AI编码代理中。

* 技能存放在一个标准的存储位置 (`~/.agents/skills`)，并通过符号链接或复制到每个代理的技能目录中
* 所有安装记录在 `~/.agents/.skill-lock.json` 的锁文件中
* 支持Cursor、Claude、Codex、Windsurf、Continue等

此功能可通过 [Olostep CLI](/sdks/cli) 使用。

## 技能

`olostep add skills` 安装所有13个技能。每个技能都有一个 `SKILL.md` 文件，供你的代理读取，以了解Olostep能做什么以及何时使用。

技能与 [MCP服务器](/integrations/mcp-server) 配合使用：MCP服务器为代理提供实时*工具*，技能则提供*知识*，以便在何时以及如何使用这些工具。

### 设置

从这里开始——教代理如何配置Olostep MCP服务器。

| 技能      | 功能                           |
| ------- | ---------------------------- |
| `setup` | 配置Olostep MCP服务器，使所有其他技能正常工作 |

### 核心网页数据

主要的Olostep功能——使用这些功能为你的代理提供实时网页访问。

| 技能               | 功能                                      |
| ---------------- | --------------------------------------- |
| `scrape`         | 将一个URL转换为干净的markdown / HTML / JSON / 文本 |
| `search`         | 实时网页搜索——结果、答案和站内URL发现                   |
| `answers`        | 从实时网页数据中获取引用的、结构化的答案                    |
| `crawl`          | 自动爬取整个网站                                |
| `map`            | 发现网站上的每个URL                             |
| `batch`          | 并行抓取多达10,000个URL                        |
| `extract-schema` | 将页面抓取为符合某个模式的结构化JSON                    |

### 构建与集成

为帮助开发者将Olostep添加到代码库或跟上API变化的代理提供支持。

| 技能             | 功能                   |
| -------------- | -------------------- |
| `integrate`    | 自动将Olostep SDK安装到项目中 |
| `docs-to-code` | 抓取API文档并从中编写可用代码     |
| `migrate-code` | 阅读迁移指南并更新本地代码        |

### 研究与调试

为进行研究、做出决策或调试代码错误的代理提供支持。

| 技能            | 功能                       |
| ------------- | ------------------------ |
| `research`    | 为决策提供引用的、比较性的网页研究        |
| `debug-error` | 在GitHub / SO / 文档中查找错误信息 |

### 分类

每个技能属于三种类别之一，这些类别映射到 `--category` 标志：

* **`usage`** — 使用Olostep的功能：`scrape`、`search`、`answers`、`crawl`、`map`、`batch`、`extract-schema`。
* **`build`** — 将Olostep安装并集成到代码库中：`setup`（配置MCP服务器）和`integrate`（将Olostep SDK添加到项目中）。
* **`workflow`** — 使用Olostep生成可交付成果：`research`、`docs-to-code`、`migrate-code`、`debug-error`。

只安装一个类别：

```bash theme={null}
olostep add skills --category usage      # 核心网页数据技能
olostep add skills --category build      # 设置+集成技能
olostep add skills --category workflow   # 研究+可交付成果技能
```

### 托管副本

每个已安装的技能还引用其托管副本，位于 `https://www.olostep.com/skills/<name>/SKILL.md` — 具有网页访问权限的代理可以获取最新版本（可能包括自安装以来添加的功能），否则会回退到本地副本。在 [olostep.com/skills](https://www.olostep.com/skills/index.md) 浏览所有托管技能。

## 安装

```bash theme={null}
npm install -g olostep-cli

# 将所有13个技能安装到每个检测到的代理中
olostep add skills

# 或使用技能子命令（别名）
olostep skills install
```

或者无需安装CLI：

```bash theme={null}
npx -y olostep-cli@latest add skills
```

## 常用用法

```bash theme={null}
# 安装所有技能
olostep skills install

# 刷新/更新到最新版本
olostep skills update

# 查看已安装的技能及其位置
olostep skills list

# 移除所有技能
olostep skills uninstall
```

过滤安装内容：

```bash theme={null}
# 仅核心网页数据技能
olostep add skills --category usage

# 仅设置+集成技能
olostep add skills --category build

# 精选
olostep add skills --skill scrape --skill search --skill setup

# 仅特定代理
olostep add skills --agent cursor --agent claude

# 机器可读输出
olostep add skills --json
```

## 选项参考

| 选项                                  | 默认值                | 描述                         |
| ----------------------------------- | ------------------ | -------------------------- |
| `--login`                           | —                  | 安装前运行浏览器登录                 |
| `--source <path>`                   | CLI捆绑技能            | 技能源目录                      |
| `--cli-local-dir <path>`            | CLI/skills         | 用于CLI本地使用的源技能同步目录          |
| `--agent <name>`                    | —                  | 针对特定代理——可重复                |
| `--all-agents` / `--no-all-agents`  | `--all-agents`     | 针对所有检测到的代理                 |
| `--global` / `--no-global`          | `--global`         | 安装到全局代理技能目录中               |
| `--canonical-dir <path>`            | `~/.agents/skills` | 标准存储位置                     |
| `--agent-skills-dir <path>`         | —                  | 自定义目标目录（需要 `--no-global`）  |
| `--skill <name>`                    | —                  | 仅包含此技能——可重复                |
| `--exclude <name>`                  | —                  | 排除此技能——可重复                 |
| `--category`                        | —                  | `usage`、`build`或`workflow` |
| `--overwrite` / `--no-overwrite`    | `--overwrite`      | 替换现有安装                     |
| `--link-mode <auto\|symlink\|copy>` | `auto`             | `auto` 首先尝试符号链接，失败则复制      |
| `--json`                            | —                  | 机器可读的JSON输出                |

<Note>
  **验证规则：**

  * `--link-mode` 必须是 `auto`、`symlink` 或 `copy`
  * `--agent-skills-dir` 需要 `--no-global`
  * `--no-global` 需要 `--agent-skills-dir`
  * 未知代理名称将导致错误
  * `--skill` / `--exclude` 后的空技能选择将导致错误
</Note>

### JSON输出格式

当传递 `--json` 时，输出如下：

```json theme={null}
{
  "sync": {
    "plugin_source_dir": "/path/to/CLI/skills",
    "cli_local_dir": "/path/to/CLI/skills"
  },
  "selected_skills": ["scrape", "search"],
  "canonical_dir": "~/.agents/skills",
  "lockfile_path": "~/.agents/.skill-lock.json",
  "installed": [
    {
      "skill": "scrape",
      "canonical_path": "~/.agents/skills/olostep-scrape",
      "targets": [
        { "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
        { "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
      ]
    }
  ]
}
```

## 支持的代理

| 代理       | 键          |
| -------- | ---------- |
| Cursor   | `cursor`   |
| Claude   | `claude`   |
| Codex    | `codex`    |
| Windsurf | `windsurf` |
| Continue | `continue` |
| Augment  | `augment`  |
| Roo      | `roo`      |
| Gemini   | `gemini`   |
| Copilot  | `copilot`  |
| Factory  | `factory`  |

使用 `--all-agents`（默认）以针对所有检测到的代理，或使用 `--agent <key>` 针对特定代理。

## `olostep list skills`

查看哪些技能已安装以及安装在哪些代理中——无需翻阅文件。

```bash theme={null}
olostep list skills            # 人类可读的摘要
olostep list skills --json     # 机器可读
```

## `olostep remove skills`

从标准存储和代理技能目录中移除Olostep安装的技能文件夹，并清理锁文件。

```bash theme={null}
# 从所有代理中移除所有Olostep技能
olostep remove skills

# 移除特定技能
olostep remove skills --skill research

# 仅从特定代理中移除
olostep remove skills --agent cursor

# 机器可读的JSON输出
olostep remove skills --json
```

| 选项                                 | 默认值                | 描述             |
| ---------------------------------- | ------------------ | -------------- |
| `--agent <name>`                   | —                  | 仅从指定代理中移除——可重复 |
| `--all-agents` / `--no-all-agents` | `--all-agents`     | 针对所有检测到的代理     |
| `--canonical-dir <path>`           | `~/.agents/skills` | 要移除的标准技能目录     |
| `--agent-skills-dir <path>`        | —                  | 自定义目标技能目录以进行移除 |
| `--skill <name>`                   | —                  | 仅移除匹配的技能——可重复  |
| `--json`                           | —                  | 机器可读的JSON输出    |

<Note>
  **安全性：** 只有带有 `olostep-` 前缀的文件夹会被触及。代理目录中的非Olostep技能文件夹不会被修改。锁文件清理仅移除带有 `olostep-` 前缀的键。
</Note>

## 技能发现和格式

通过扫描子目录中的 `SKILL.md` 文件来发现技能。文件必须包含一个带有 `name` 和 `description` 字段的YAML前置块。重复的已消毒名称将被拒绝。

```markdown theme={null}
---
name: my-skill
description: 该技能的功能及使用时机
---

# 我的技能

...技能说明在这里...
```

## 命名约定

安装的文件夹总是使用 `olostep-` 前缀——例如 `research` 变为 `olostep-research`。名称被消毒为小写，并用 `-` 替换无效字符。此前缀使Olostep管理的技能清晰可辨，并防止与其他工具发生冲突。

## 相关内容

* [CLI参考](/sdks/cli) — 完整命令文档
* [MCP服务器](/integrations/mcp-server) — 为你的代理提供实时Olostep工具