代理技能#

代理技能让 MiMo Code 能够从你的仓库或主目录中发现可复用的指令。 技能通过原生的 skill 工具按需加载——代理可以查看可用技能，并在需要时加载完整内容。

放置文件#

在文件夹中放入 SKILL.md。技能的名称来自其 frontmatter——而非文件夹名——且 SKILL.md 会被递归发现，因此你可以任意嵌套目录。

MiMo Code 会搜索以下位置：

• 项目配置：.mimocode/skills/**/SKILL.md（单数形式的 skill/ 文件夹同样有效）
• 全局配置：~/.config/mimocode/skills/**/SKILL.md
• 项目兼容目录：.claude、.agents、.codex 和 .opencode——每个都按 skills/**/SKILL.md 扫描
• 全局兼容目录：~/ 下的同样四个文件夹（例如 ~/.claude/skills/**/SKILL.md）

可通过 skills.paths 和 skills.urls 配置项添加更多来源。

了解发现机制#

对于项目本地路径，MiMo Code 会从当前工作目录向上遍历，直到到达工作区根目录。 在此过程中，它会加载 .mimocode/ 中所有匹配的 skills/**/SKILL.md（或 skill/**/SKILL.md），以及 .claude、.agents、.codex 和 .opencode 目录中的 skills/**/SKILL.md。

全局定义也会从 ~/.config/mimocode/ 以及主目录下的同样这些兼容目录中加载（例如 ~/.claude/skills/**/SKILL.md）。

如果两个技能解析出相同的 name，则后加载的优先（last-one-wins），并会记录一条警告。

编写 frontmatter#

每个 SKILL.md 必须以 YAML frontmatter 开头。 仅读取以下字段：

• name（必填）
• description（必填）
• hidden（可选布尔值——为 true 时技能仍会加载，但不会出现在可用技能列表中）

其他任何 frontmatter 字段都会被忽略。

命名技能#

MiMo Code 不会对 name 的格式或 description 的长度做强制校验，但 name 是代理引用技能的方式，所以请保持简短、可预测。建议使用小写字母和数字、以单个连字符分隔，例如 git-release。

请让 description 足够具体，以便代理能正确选择技能——在加载完整内容之前，这是代理唯一能看到的信号。

使用示例#

创建 .mimocode/skills/git-release/SKILL.md，内容如下：

1name: git-release
2description: Create consistent releases and changelogs
3
4## What I do
5
6- Draft release notes from merged PRs
7- Propose a version bump
8- Provide a copy-pasteable `gh release create` command
9
10## When to use me
11
12Use this when you are preparing a tagged release.
13Ask clarifying questions if the target versioning scheme is unclear.

识别工具描述#

MiMo Code 会在 skill 工具描述中列出可用技能。 每个条目包含技能名称和描述：

1<available_skills>
2  <skill>
3    <name>git-release</name>
4    <description>Create consistent releases and changelogs</description>
5  </skill>
6</available_skills>

代理通过调用工具来加载技能：

1skill({ name: "git-release" })

配置权限#

在 mimocode.json 中使用基于模式的权限来控制代理可以访问哪些技能：

1{
2  "permission": {
3    "skill": {
4      "*": "allow",
5      "pr-review": "allow",
6      "internal-*": "deny",
7      "experimental-*": "ask"
8    }
9  }
10}

模式支持通配符：internal-* 可匹配 internal-docs、internal-tools 等。

按代理覆盖权限#

为特定代理授予与全局默认值不同的权限。

自定义代理（在代理 frontmatter 中）：

1permission:
2  skill:
3    "documents-*": "allow"

内置代理（在 mimocode.json 中）：

1{
2  "agent": {
3    "plan": {
4      "permission": {
5        "skill": {
6          "internal-*": "allow"
7        }
8      }
9    }
10  }
11}

禁用技能工具#

为不需要使用技能的代理完全禁用技能功能：

自定义代理：

1tools:
2  skill: false

内置代理：

1{
2  "agent": {
3    "plan": {
4      "tools": {
5        "skill": false
6      }
7    }
8  }
9}

禁用后，<available_skills> 部分将被完全省略。

排查加载问题#

如果某个技能没有显示：

1. 确认 SKILL.md 文件名全部为大写字母
2. 检查 frontmatter 是否包含 name 和 description
3. 确保技能名称唯一——重名的 name 会被静默覆盖（后加载的优先）
4. 检查权限设置——设为 deny 的技能会对代理隐藏