技能 - Olostep Docs

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

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

此功能可通过 Olostep CLI 使用。

技能

olostep add skills 安装所有13个技能。每个技能都有一个 SKILL.md 文件，供你的代理读取，以了解Olostep能做什么以及何时使用。技能与 MCP服务器配合使用：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。

只安装一个类别：

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 浏览所有托管技能。

安装

npm install -g olostep-cli

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

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

或者无需安装CLI：

npx -y olostep-cli@latest add skills

常用用法

# 安装所有技能
olostep skills install

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

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

# 移除所有技能
olostep skills uninstall

过滤安装内容：

# 仅核心网页数据技能
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输出

验证规则：

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

JSON输出格式

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

{
  "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`

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

olostep list skills            # 人类可读的摘要
olostep list skills --json     # 机器可读

`olostep remove skills`

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

# 从所有代理中移除所有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输出

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

技能发现和格式

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

---
name: my-skill
description: 该技能的功能及使用时机
---

# 我的技能

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

命名约定

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

开始使用

功能

余额与账单

技能

技能

设置

核心网页数据

构建与集成

研究与调试

分类

托管副本

安装

常用用法

选项参考

JSON输出格式

支持的代理

`olostep list skills`

`olostep remove skills`

技能发现和格式

命名约定

相关内容

​技能

​设置

​核心网页数据

​构建与集成

​研究与调试

​分类

​托管副本

​安装

​常用用法

​选项参考

​JSON输出格式

​支持的代理

​olostep list skills

​olostep remove skills

​技能发现和格式

​命名约定

​相关内容

技能

设置

核心网页数据

构建与集成

研究与调试

分类

托管副本

安装

常用用法

选项参考

JSON输出格式

支持的代理

`olostep list skills`

`olostep remove skills`

技能发现和格式

命名约定

相关内容