扩展与技能生态

技能、AGX Bundle 与技能市场 — 用领域知识、MCP 服务器、分身预设与记忆模板扩展 AgenticX。

扩展与技能生态

AgenticX 支持三层扩展模型，可引入领域知识、外部工具、分身预设与记忆模板——既可手工编写，也可从社区获取。

层级	含义	安装路径
Skill	`SKILL.md` — 注入智能体上下文的领域知识说明	`.agents/skills/`、`~/.agents/skills/` 或任意配置目录
MCP Server	通过 Model Context Protocol 提供的外部能力（工具、数据库、Web）	`~/.agenticx/mcp.json`
AGX Bundle	组合上述任意内容的包（skills + MCP + avatars + memory templates）	`~/.agenticx/skills/bundles/<bundle-name>/`

技能（Skills）

什么是 Skill？

Skill 是带可选 YAML front matter 的 `SKILL.md` 文件，告诉智能体在特定领域如何思考。与 MCP 服务器（提供新工具）不同，Skill 提供新的知识与流程。

1my-skill/
2└── SKILL.md

markdown

1---
2name: deep-research-sop
3description: SOP for conducting exhaustive deep research
4---
5
6# Deep Research SOP
7
8When asked to research a topic:
91. First, clarify the scope...
102. Search at least 3 independent sources...
11...

技能发现路径

SkillBundleLoader 按优先级扫描以下路径：

路径	范围
`./.agents/skills/`	当前项目
`./.agent/skills/`	当前项目（备用）
`~/.agents/skills/`	用户全局
`~/.agent/skills/`	用户全局（备用）
`./.claude/skills/`	兼容 Claude Code
`~/.claude/skills/`	Claude Code 全局
`~/.agenticx/skills/bundles/`	AGX Bundle 安装
包内置技能	AgenticX 默认

提示： .cursor/skills/ 或 .agents/skills/ 中已有的 SKILL.md 会自动被发现，无需迁移。

在 Desktop 中查看技能

打开 设置 → 技能 标签页，可查看所有已发现技能、按名称或描述搜索、点击任意技能查看完整 SKILL.md 内容，添加新技能后刷新列表即可。

在对话中使用技能

技能会自动注入智能体上下文。也可显式激活：

1skill_use("deep-research-sop")

或列出可用技能：

1skill_list()

AGX Bundle

什么是 AGX Bundle？

AGX Bundle 是以 agx-bundle.yaml 清单标识的可分发目录包，可包含以下任意组合：

Skills — SKILL.md 文件
MCP Servers — JSON 配置文件
Avatar Presets — 智能体人设预设 YAML
Memory Templates — 记忆流水线 Markdown 模板

Bundle 目录结构

1my-bundle/
2├── agx-bundle.yaml            ← required manifest
3├── skills/
4│   └── deep-research/
5│       └── SKILL.md
6├── mcp/
7│   └── web-crawler.json
8├── avatars/
9│   └── researcher.yaml
10└── memory/
11    └── research-workflow.md

`agx-bundle.yaml` 格式

yaml

1agx_bundle: "1.0"           # format version (required)
2name: "deep-research-kit"   # bundle identifier (required)
3version: "1.0.0"
4description: "Complete deep research toolkit"
5author: "Damon Li"
6license: "MIT"
7
8components:
9  skills:
10    - path: skills/deep-research/SKILL.md
11      description: "Deep research SOP"
12
13  mcp_servers:
14    - name: web-crawler
15      config_path: mcp/web-crawler.json
16      description: "Web crawling MCP server"
17
18  avatars:
19    - name: researcher
20      config_path: avatars/researcher.yaml
21      description: "Research specialist avatar preset"
22
23  memory_templates:
24    - name: research-workflow
25      path: memory/research-workflow.md
26      description: "Memory template for research sessions"

四个 components 区块均为可选 — 仅含 skills 的 bundle 完全有效。

安全约束

解析器强制：

所有路径必须为相对路径（禁止绝对路径）
路径不得逃出 bundle 目录（禁止 ../ 穿越）
无效条目会跳过并警告；安装不会因此中止

安装 Bundle

Desktop 图形界面

打开 设置 → 技能 标签页
滚动到 已安装扩展包
在输入框粘贴 bundle 目录的绝对路径
点击安装

技能会出现在上方技能列表中，MCP 服务器会合并进 ~/.agenticx/mcp.json。

Python API

python

1from pathlib import Path
2from agenticx.extensions.installer import install_bundle, list_installed_bundles
3
4result = install_bundle(Path("/path/to/my-bundle"))
5if result.success:
6    print(f"Installed {result.name} v{result.version}")
7    print(f"Skills: {result.skills_installed}")
8    print(f"MCP servers: {result.mcp_servers_installed}")
9
10for bundle in list_installed_bundles():
11    print(bundle.name, bundle.version)

安装后的落盘位置

组件	目标路径
Skills	`~/.agenticx/skills/bundles/<name>/<skill-dir>/`
MCP servers	合并到 `~/.agenticx/mcp.json` 的 `mcpServers`
Avatar presets	`~/.agenticx/avatars/presets/<name>/<avatar>.yaml`
Memory templates	`~/.agenticx/workspace/memory_templates/<name>/`
安装记录	`~/.agenticx/bundles.json`

卸载 Bundle

Desktop 图形界面

在 设置 → 技能 → 已安装扩展包 中，点击 bundle 名称旁的卸载。

Python API

python

1from agenticx.extensions.installer import uninstall_bundle
2
3uninstall_bundle("deep-research-kit")

技能市场

配置注册表源

编辑 ~/.agenticx/config.yaml 添加注册表源：

yaml

1extensions:
2  registries:
3    - name: official
4      url: https://registry.agxbuilder.com
5      type: agx                          # AgenticX native registry
6    - name: community
7      url: https://example.com/agx-registry.json
8      type: agx
9    - name: clawhub
10      url: https://clawhub.ai/api
11      type: clawhub                      # ClawHub skills market
12  scan_dirs:
13    - ~/.agenticx/bundles
14    - ~/.agenticx/skills/registry

支持两种注册表类型：

类型	说明
`agx`	AgenticX 原生注册表 — 与 `agenticx.skills.registry` 兼容的 REST API
`clawhub`	ClawHub 技能市场 — 从 clawhub.ai 搜索并安装 `SKILL.md`

搜索市场

Desktop 图形界面

打开 设置 → 技能 标签页
滚动到 浏览市场
在搜索框输入关键词，按 Enter 或点击搜索
结果展示名称、描述、作者、版本与来源 badge
点击任意结果的安装

Python API

python

1from agenticx.extensions.registry_hub import RegistryHub
2
3hub = RegistryHub.from_config()          # reads ~/.agenticx/config.yaml
4results = hub.search("deep research")
5
6for r in results:
7    print(r.name, r.source_type, r.source)
8    print(r.description)
9    print(r.install_hint)

从注册表安装

python

1result = hub.install("clawhub", "web-crawler-skill")
2if result.success:
3    print(f"Installed to {result.installed_path}")

从注册表安装的技能位于 ~/.agenticx/skills/registry/<skill-name>/SKILL.md，SkillBundleLoader 可立即发现。

快速参考

最小 Skill（无需 bundle）

创建 ~/.agents/skills/my-skill/SKILL.md：

markdown

1---
2name: my-skill
3description: What this skill does
4---
5
6Instructions for the agent...

完成。下次扫描时会自动发现该技能。

最小 Bundle（仅 skills）

1my-bundle/
2├── agx-bundle.yaml
3└── skills/
4    └── my-skill/
5        └── SKILL.md

yaml

1# agx-bundle.yaml
2agx_bundle: "1.0"
3name: "my-bundle"
4version: "1.0.0"
5description: "My first AGX Bundle"
6author: "me"
7
8components:
9  skills:
10    - path: skills/my-skill/SKILL.md
11      description: "My custom skill"

python

1from pathlib import Path
2from agenticx.extensions.installer import install_bundle
3install_bundle(Path("./my-bundle"))

接入 ClawHub 市场

在 ~/.agenticx/config.yaml 中添加：

yaml

1extensions:
2  registries:
3    - name: clawhub
4      url: https://clawhub.ai/api
5      type: clawhub

然后在 设置 → 技能 → 浏览市场 中搜索。