跳转到主要内容

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.

直接从命令行将Olostep技能文件夹安装到你的AI编码代理中。
  • 将Olostep技能安装到代理中，如Cursor、Claude、Codex、Windsurf等
  • 技能存放在一个标准的存储位置（~/.agents/skills），并通过符号链接或复制到每个代理的技能目录中
  • 在~/.agents/.skill-lock.json的锁文件中跟踪所有安装
此功能可通过Olostep CLI使用。

​
技能

olostep add skills安装所有这些技能。每个技能都是一个SKILL.md文件，你的代理读取它以了解Olostep可以做什么以及何时使用它。
技能功能
scrape将一个URL转换为干净的markdown / HTML / JSON / 文本
search实时网络搜索——结果、答案和站内URL发现
answers来自实时网络数据的引用、结构化答案
crawl自动爬取整个网站
map发现网站上的每个URL
batch并行抓取多达10,000个URL
extract-schema将页面抓取为匹配模式的结构化JSON
docs-to-code抓取API文档并从中编写工作代码
integrate自动将Olostep SDK安装到项目中
migrate-code阅读迁移指南并更新本地代码
research为决策提供引用的、比较性的网络研究
debug-error在GitHub / SO / 文档中查找错误信息
setup教代理如何配置MCP服务器
技能与MCP服务器配对：MCP服务器为代理提供实时工具，技能为其提供知识，以便知道何时以及如何使用它们。

​
分类

每个技能属于以下三类之一：
  • 使用技能 — 使用Olostep的功能：scrape、search、answers、crawl、map、batch。
  • 构建技能 — 安装和集成Olostep到代码库中：setup（配置MCP服务器）和integrate（将Olostep SDK添加到项目中）。
  • 工作流技能 — 使用Olostep生成可交付成果：research、docs-to-code、migrate-code、debug-error、extract-schema。
使用olostep add skills --category usage（或build，或workflow）安装一个类别。 每个已安装的技能也引用其托管副本，位于https://www.olostep.com/skills/<name>/SKILL.md — 具有网络访问权限的代理可以获取最新版本（可能在安装后增加了功能），否则回退到本地副本。浏览所有托管技能请访问olostep.com/skills。

​
olostep add skills

将技能从源目录同步到CLI，安装到标准存储中，然后部署到每个代理的技能目录中。

​
安装CLI

# 全局安装
npm install -g olostep-cli

# 或不安装直接运行
npx -y olostep-cli@latest add skills

​
用法

# 将所有技能安装到所有检测到的代理中（默认）
olostep add skills

# 先认证，然后安装
olostep add skills --login

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

# 始终复制而不是符号链接
olostep add skills --link-mode copy

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

​
选项

选项默认描述
--login—安装前运行浏览器登录
--source <path>CLI捆绑的技能目录技能源目录
--cli-local-dir <path>CLI/skills用于CLI本地使用的源技能同步目录
--agent <name>—针对特定代理 — 可重复
--all-agents / --no-all-agents--all-agents如果未设置--agent，则针对所有检测到的已安装代理
--global / --no-global--global安装到已知代理的全局技能目录中
--canonical-dir <path>~/.agents/skillsOlostep技能的标准存储位置
--agent-skills-dir <path>—自定义目标技能目录（需要--no-global）
--skill <name>—仅包含此技能 — 可重复
--exclude <name>—排除此技能 — 可重复
--overwrite / --no-overwrite--overwrite替换现有目标
--link-mode <auto|symlink|copy>autoauto尝试符号链接，回退到复制
--json—输出机器可读的JSON
验证规则：
  • --link-mode必须是auto、symlink或copy
  • --agent-skills-dir需要--no-global
  • --no-global需要--agent-skills-dir
  • 未知的代理名称将导致错误
  • --skill / --exclude后没有选择技能将导致错误

​
JSON输出

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

​
olostep list skills

查看哪些技能已安装以及安装到哪些代理中——无需翻阅文件。 
olostep list skills            # 人类可读的摘要
olostep list skills --json     # 机器可读

​
技能发现和格式

通过扫描子目录中的SKILL.md文件来发现技能。文件必须包含一个带有name和description字段的前置块。重复的已清理名称将被拒绝。 
---
name: research-agent
description: 用于深度网络调查的自主研究代理
---

# 研究代理

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

​
支持的代理

代理键
Cursorcursor
Claudeclaude
Codexcodex
Windsurfwindsurf
Continuecontinue
Augmentaugment
Rooroo
Geminigemini
Copilotcopilot
Factoryfactory
每个键映射到已知的主目录技能路径。使用--all-agents（默认）来针对所有检测到的已安装代理，或传递--agent <key>来针对特定代理。

​
命名约定

已安装的文件夹名称始终使用olostep-前缀：例如，research-agent变为olostep-research-agent。名称被清理为小写，非法字符被替换为-。此前缀使Olostep管理的技能易于识别，并防止与其他工具发生冲突。

​
olostep remove skills

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

​
用法

# 从所有代理中移除所有Olostep技能
olostep remove skills

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

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

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

​
选项

选项默认描述
--agent <name>—仅从指定代理中移除 — 可重复
--all-agents / --no-all-agents--all-agents如果没有--agent或自定义目录，使用所有检测到的已安装代理
--canonical-dir <path>~/.agents/skills要移除的标准技能目录
--agent-skills-dir <path>—自定义目标技能目录以进行移除
--skill <name>—仅移除匹配的技能 — 可重复
--json—输出机器可读的JSON
安全性： 只有带有olostep-前缀的文件夹会被触及。非Olostep代理文件夹从不被修改。锁文件清理仅移除带有olostep-前缀的键。