跳到主要内容

Skills

Skills 是教 agent 何时以及如何使用工具的方式。每个 Skill 是一个包含 SKILL.md 的目录，为 agent 提供特定领域的操作流程和指导。

Skills 如何工作​

  1. 发现

    运行时从配置的 skill roots 目录递归扫描 SKILL.md 文件。默认目录为 ~/.MushroomAgent/skills/。

  2. 选择

    当用户请求与某个 Skill 明显匹配时，agent 会优先决定是否启用这个 Skill。

  3. 读取

    一旦命中，agent 会通过 read 工具读取对应 SKILL.md。

Skills 目录结构​

~/.MushroomAgent/
└── skills/
    └── skill-name/
        ├── SKILL.md (必需)
        ├── scripts/          # 可执行脚本
        ├── references/       # 参考文档
        └── assets/           # 资源文件

SKILL.md 结构​

---
name: skill-name
description: Skill 的描述，说明何时应该使用此 Skill
---

# Skill Name

## 操作指导

frontmatter 字段：

字段必填描述
name是唯一标识符
description是展示给 agent 的描述

相关内容​