# Agent Framework 目录结构

> 框架与应用分层设计

---

## 核心架构

**框架层** (`agent/`): 核心代码、内置预设，可作为独立包发布

**应用层** (项目根目录): 项目特定配置，覆盖或扩展框架

---

## 框架层（`agent/`）

```
agent/
├── tools/builtin/              # 内置基础工具
├── tools/advanced/             # 高级工具（第三方适配）
├── skills/                     # 框架内置 Skills
│   └── browser_use/            # 浏览器自动化 skill
├── presets/subagents/          # 内置 Sub-Agent 定义
└── runner.py                   # Agent 运行器
```

**实现**：
- 工具系统：`agent/tools/`
- Skills：`agent/skills/browser_use/`（含文档和环境配置）
- Sub-Agent 预设：`agent/subagents/default.json`

---

## 应用层（项目根目录）

项目特定配置（可选）：

```
your-project/
├── skills/                     # 项目特定 Skills
├── subagents/                  # 项目特定 Sub-Agents
└── tools/                      # 项目特定工具
```

---

## 加载优先级

| 资源 | 框架预设 | 项目配置 | 优先级 |
|------|---------|---------|--------|
| Skills | `agent/skills/` | `./skills/` | 项目优先 |
| Sub-Agents | `agent/subagents/default.json` | `./subagents/*.json` | 项目覆盖 |
| Tools | `agent/tools/builtin/` | `./tools/` | 手动注册 |

**实现**：
- Skills 多路径查找：`agent/tools/builtin/skill.py` - `DEFAULT_SKILLS_DIRS`
- Sub-Agents 加载：按顺序加载配置，后加载的覆盖先加载的

---

## 使用方式

### 加载框架预设

```python
from agent.agent_registry import get_agent_registry

registry = get_agent_registry()
registry.load_from_config("agent/subagents/default.json")
```

### 扩展框架（可选）

```python
# 项目特定配置覆盖框架预设
from pathlib import Path
if Path("./subagents/custom.json").exists():
    registry.load_from_config("./subagents/custom.json")
```

Skills 和工具自动按优先级加载。

---

## 相关文档

- [Sub-Agent 配置](./sub-agents.md) - Sub-Agent 定义格式
- [Skills](./skills.md) - Skill 使用和编写
- [工具系统](./tools.md) - 工具注册和使用