> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Agent Skills（SKILL.md）不是 Mirobody C++ 引擎的一部分。请改用 MCP 工具来扩展 Agent。

<Note>
  **Mirobody C++ 引擎中没有 skills 注册表。** 那套 `SKILL.md` + `metadata.json` 的 "Agent Skills" 机制 —— 一个在启动时被自动发现的 `skills/` 目录 —— 属于更早期的设计，**在当前的 C++ 引擎（Mirobody）中并未实现**。`res/agents/base.cpp` 中的那个唯一 Agent 会构建一段固定的内联 system prompt，按 provider 选择一个 LLM 客户端，并把这一轮流式返回，其间调用内置的 **MCP 工具**。它不会加载 `SKILL.md` 文件，也没有 skill 加载器。
</Note>

## 应该改用什么

扩展 Agent 能力的方式，是添加一个 **MCP 工具** —— 一个位于 `res/mcp_tools/` 中、在编译时自注册的小小 C++ 文件。工具是"Agent 调用的代码"：模型像调函数那样调用它，并读取其返回值。不存在单独的"Agent 加载进上下文的散文"这一层。

<CardGroup cols={2}>
  <Card title="添加自定义工具" icon="wrench" href="/zh/tools/adding-tools">
    用 `MIROBODY_REGISTER_TOOL` 宏在 `res/mcp_tools/` 中添加一个 C++ 工具，然后重新构建。
  </Card>

  <Card title="内置工具" icon="list" href="/zh/tools/built-in">
    引擎默认提供的 9 个 MCP 工具。
  </Card>
</CardGroup>

## 引导 Agent 的行为

如果你想改变 Agent *如何*行事 —— 它的语气、它了解的领域，或者它何时去调用某个工具 —— C++ 引擎中的调节杆是：

* **System prompt。** Agent 的指令是 [`res/agents/base.cpp`](https://github.com/thetahealth/mirobody/blob/main/res/agents/base.cpp) 中构建的一段固定内联字符串（`build_system_prompt`）。它已经告诉模型通过 `list_files` / `read_file` 获取上传文件、通过 `family_health` 获取健康记录。编辑这段字符串并重新构建，即可改变 Agent 的常驻指令。
* **工具描述。** 每个工具的 `description` 及其每个 `Param` 的文字（声明在它的 `res/mcp_tools/*.cpp` 中），是模型在决定是否以及如何调用它时所看到的内容 —— 因此清晰的描述是引导使用方式的主要途径。示例见 [内置工具](/zh/tools/built-in)。

<Warning>
  改 prompt 或加工具都是**编译期**改动：编辑 `.cpp`，然后用 `./build.sh` 重新构建。两者都没有运行时插件方式。
</Warning>

## 下一步

<CardGroup cols={2}>
  <Card title="工具与 Agent 概览" icon="brain" href="/zh/tools/overview">
    那个唯一的 Agent、MCP 工具与 provider 如何协同。
  </Card>

  <Card title="MCP 集成" icon="bolt" href="/zh/tools/mcp-integration">
    通过 `/mcp` 把工具暴露给 Claude、Cursor 和 ChatGPT。
  </Card>
</CardGroup>