内置 Agent

Elftia 提供了一个 Agent 市场（Gallery），预置了多种场景的 Agent 配置。你可以直接使用这些 Agent，也可以基于它们创建自定义版本。

Agent 市场

Agent 市场将预置 Agent 按使用场景分为多个类别，方便快速查找。

浏览 Agent

点击侧边栏的 Agent 图标 打开 Agent 面板
在顶部可以看到 市场 / 我的 Agent 切换标签
选择「市场」标签浏览所有预置 Agent
使用搜索框或类别筛选快速定位

Agent 类别

类别	图标	包含的 Agent 类型
Work	工作	项目管理、任务分解、会议纪要、周报
Business	商务	商业分析、市场研究、策划方案
Tools	工具	文件处理、数据转换、自动化脚本
Language	语言	翻译、校对、语法检查、多语言
Office	办公	文档撰写、表格处理、演示文稿
Creative	创意	文案创作、故事编写、头脑风暴
Coding	编程	代码生成、代码审查、Bug 修复、测试
Education	教育	知识问答、课程辅导、学习计划

选择和使用 Agent

在市场中点击感兴趣的 Agent 卡片
查看 Agent 的详细信息：
- 描述 — Agent 的能力和适用场景
- 工具列表 — Agent 可以使用的工具
- 权限模式 — 工具执行的安全级别
- 模型 — Agent 使用的 LLM 模型
点击「使用」按钮开始对话
也可以点击「收藏」将 Agent 添加到快速访问列表

收藏与评分

收藏 — 点击 Agent 卡片上的星标图标，收藏后的 Agent 会出现在「我的 Agent」列表顶部
评分 — 使用后可以为 Agent 评分，帮助其他用户发现优质 Agent

Agent 配置格式

每个 Agent 本质上是一个 Markdown 文件，使用 YAML frontmatter 定义配置参数，正文部分作为系统提示（System Prompt）。

文件结构

---
name: 代码审查助手
description: 审查代码质量，发现潜在问题，提出改进建议
model: main
permissionMode: default
tools:
  - Read
  - Glob
  - Grep
  - ListDir
skills:
  - code-standards
---

你是一个专业的代码审查助手。

## 审查重点

1. 代码质量和可读性
2. 潜在的 Bug 和性能问题
3. 安全漏洞
4. 最佳实践遵循情况

## 输出格式

对每个发现的问题，给出：
- 问题描述
- 严重程度（高/中/低）
- 修改建议

配置字段说明

字段	类型	必填	说明
`name`	string	是	Agent 名称
`description`	string	是	Agent 描述（显示在市场卡片中）
`model`	string	否	模型选择（支持别名，默认 `main`）
`permissionMode`	string	否	权限模式（默认 `default`）
`tools`	string[]	否	允许使用的工具列表（空则继承所有）
`skills`	string[]	否	自动加载的技能名称列表

模型别名

Agent 配置中的 model 字段支持以下别名，让配置不绑定具体模型：

别名	含义	说明
`main`	主模型	使用当前会话配置的主模型（默认）
`inherit`	继承模型	与 `main` 相同，继承父 Agent 模型
`background`	后台模型	使用用户配置的后台模型（轻量级）
`sonnet`	Sonnet 系列	将父模型切换为 Sonnet 系列（仅 Anthropic）
`opus`	Opus 系列	将父模型切换为 Opus 系列（仅 Anthropic）
`haiku`	Haiku 系列	将父模型切换为 Haiku 系列（仅 Anthropic）

:::tip 推荐使用语义别名推荐使用 main、inherit、background 等语义别名，它们不绑定特定提供商。sonnet、opus、haiku 仅在使用 Anthropic 模型时有效。 :::

权限模式

模式	说明
`default`	敏感工具（Bash、Write、Edit）需要用户确认
`acceptEdits`	文件编辑自动通过，Shell 和 MCP 工具仍需确认
`bypassPermissions`	所有工具自动执行，不需要确认
`plan`	只读模式，仅能使用 Read、ListDir、Glob、Grep 等只读工具

Agent 存储位置

Agent 配置文件可以放在以下位置：

位置	路径	作用域
项目级	`.claude/agents/*.md`	仅当前项目可用
个人级	`~/.claude/agents/*.md`	所有项目可用
内置	应用内置	所有用户可用

加载优先级：项目级 > 个人级 > 内置。同名 Agent 中，项目级覆盖个人级。

常见问题

问题	原因	解决方案
市场中看不到某个 Agent	Agent 配置文件不在正确路径	检查文件是否在 `.claude/agents/` 目录下
Agent 无法使用某个工具	`tools` 字段中未列出该工具	在 frontmatter 中添加工具名称
模型别名不生效	使用了仅 Anthropic 支持的别名	改用 `main` 或 `background` 语义别名
自定义 Agent 在其他项目看不到	放在了项目级目录	移动到 `~/.claude/agents/` 个人级目录

Agent 市场​

浏览 Agent​

Agent 类别​

选择和使用 Agent​

收藏与评分​

Agent 配置格式​

文件结构​

配置字段说明​

模型别名​

权限模式​

Agent 存储位置​

常见问题​

相关链接​