Agent/docs/project-structure.md

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 加载：按顺序加载配置，后加载的覆盖先加载的

---

使用方式

加载框架预设

from agent.agent_registry import get_agent_registry

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

扩展框架（可选）

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

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

---

相关文档

• Sub-Agent 配置 - Sub-Agent 定义格式
• Skills - Skill 使用和编写
• 工具系统 - 工具注册和使用