Tools

MushroomAgent 通过工具和 Skills 扩展 agent 的能力。工具是 agent 可以调用的函数，Skills 则为 agent 提供领域知识和操作指导。

工具、Skills

1. 工具是 agent 调用的内容

   工具是 agent 可调用的类型化函数，例如 exec、read、web_fetch、web_search、媒体工具、memory 工具和 delegation。MushroomAgent 会从 tools.* 配置加载 builtin tools，也可以发现 MCP tools。

2. Skills 为 agent 提供领域知识

   Skill 是包含 SKILL.md 的目录，提供特定领域的操作流程、最佳实践和脚本。agent 根据请求上下文自动匹配并加载相关 Skills。

内置工具

工具	作用
read	读取工作区文本和图片文件
exec	执行 shell 命令，带超时和输出限制
process	管理较长时间运行的后台进程
web_fetch	抓取网页或 HTTP 响应内容
web_search	通过配置的 backend 搜索网页
image_generation	通过配置的 provider 生成图片
video_generation	通过 VolcEngine Ark 或 Google provider 设置生成视频
video_analyze / audio_analyze	通过配置的 provider 分析媒体
attach_artifact	把生成的 artifact 附加到回复上下文
memory_search / memory_add_file	搜索 memory，并把本地文件加入 memory
skill_manage / skill_view	在允许的 skill roots 中创建、编辑和查看 skills
delegate_task	在明确启用 delegation 时派生子 agent
manage_schedule	计划任务和提醒
skip_voice_reply / emit_ui_command	语音/UI runtime 辅助工具
update_identity_profile	启用后更新身份档案数据

使用 CLI 查看当前本地配置实际可用的 tools：

mushroom-agent tools list

当前默认 builtin registry 不注册独立的 write 或 api_request 工具。本地自动化使用 exec / process，网页访问使用 web_fetch / web_search，外部系统集成使用 MushroomAgent 的 HTTP/WebSocket/Func 服务 API。

Skills

Skills 默认存放在本地 skills root。由 mushroom-agent init 创建的 starter 中，这通常是 ~/.mushroom_agent/skills/。当 skills.include_bundled=true 时，也会包含官方 bundled skills。

详细说明：

• Skills 概览
• 创建 Skills
• Skills 配置
• Skills Hub

常用命令：

mushroom-agent skills list           # 查看已安装的 skills
mushroom-agent skills available      # 查看可用的 skills
mushroom-agent skills install <name> # 安装 skill