快速开始

在本教程中，你将安装 OntoSkills 并对已编译的技能本体运行你的第一个 SPARQL 查询。

完成后你将拥有：

预计时间：~5 分钟

前置条件

开始之前，确保你有：

打开终端并运行：

npx ontoskills install mcp

这将在 ~/.ontoskills/ 下创建一个托管主目录，包含：

预期输出：

✓ 已安装 ontomcp 到 ~/.ontoskills/bin/ontomcp
✓ 已创建 ~/.ontoskills/ontologies/
✓ 已创建 ~/.ontoskills/state/

OntoStore 已内置。让我们安装一个问候技能：

ontoskills search hello

预期输出：

找到 1 个技能：
  mareasw/greeting/hello - 简单的问候技能

安装它（安装后自动启用）：

ontoskills install mareasw/greeting/hello

预期输出：

✓ 已安装 mareasw/greeting/hello

现在让我们用 SPARQL 查询已安装的技能：

ontoskills query "SELECT ?skill ?intent WHERE { ?skill a oc:Skill . ?skill oc:resolvesIntent ?intent }"

预期输出：

?skill                    ?intent
─────────────────────────────────────
skill:hello               "say_hello"

你刚刚查询了一个已编译的本体。结果是确定性的 — 相同的查询，相同的结果，每次都是。

如果你想从源文件编写自定义技能，安装编译器：

ontoskills install core

系统要求：

export ANTHROPIC_API_KEY="你的-key"
ontoskills init-core

这会创建 core.ttl — 包含类和属性的基础本体。

创建一个简单的技能：

mkdir -p skills/my-first-skill

创建 skills/my-first-skill/SKILL.md：

# 我的第一个技能

一个简单的演示技能。

## 功能

这个技能按名字问候用户。

## 何时使用

当用户想要友好的问候时使用。

## 如何使用

1. 询问用户的名字
2. 说"你好，{名字}！"

编译它：

ontoskills compile my-first-skill

预期输出：

✓ 已编译 my-first-skill
  性质: 一个简单的演示技能
  意图: greet_user

查询你的技能：

ontoskills query "SELECT ?intent WHERE { skill:my_first_skill oc:resolvesIntent ?intent }"

现在你已经设置好了：

确保你运行了 npx ontoskills install mcp，并且 ~/.ontoskills/bin 目录在你的 PATH 中，或者使用 npx ontoskills 作为命令。

export ANTHROPIC_API_KEY="你的-key"

将此添加到你的 shell 配置文件（~/.bashrc、~/.zshrc）以持久化。

技能安装后默认启用。如果之前禁用了，重新启用：

ontoskills enable mareasw/greeting/hello

你的技能缺少必需字段。检查：

使用 -v 查看详细信息：

ontoskills compile my-skill -v