diff --git a/.agents/skills/ulthon-base-app-architecture/SKILL.md b/.agents/skills/ulthon-base-app-architecture/SKILL.md
index 4a970e7..6e8c17d 100644
--- a/.agents/skills/ulthon-base-app-architecture/SKILL.md
+++ b/.agents/skills/ulthon-base-app-architecture/SKILL.md
@@ -130,3 +130,31 @@ App 应用层（app/，框架使用者维护）
 | `extend/base/common/service/SmsBase.php` | `app/common/service/Sms.php` |
 | `extend/base/common/command/CurdBase.php` | `app/common/command/Curd.php` |
 | `extend/base/common/command/admin/role/AdminRoleCreateBase.php` | `app/common/command/admin/role/AdminRoleCreate.php` |
+
+### 项目结构总览
+
+```
+ulthon_admin/
+├── app/                    # 应用层（业务代码唯一入口）
+│   ├── admin/              # 后台管理模块（控制器、模型、视图、Scheme）
+│   ├── common/             # 公共代码（命令、服务、工具类）
+│   └── tools/              # 工具控制器（定时任务等）
+├── extend/
+│   ├── base/               # 框架内核（*Base.php，禁止业务修改）
+│   └── think/              # ThinkPHP 扩展（存储驱动、日志、迁移）
+├── config/                 # ThinkPHP 配置
+├── public/                 # Web 入口 + 静态资源
+├── view/                   # 视图覆盖层
+├── route/                  # 路由定义
+├── database/               # 数据库迁移与种子
+├── tests/                  # 测试目录
+├── source/                 # 主工程外内容统一目录（多端代码/资料/附件/子项目）
+│   ├── assets/             # 静态资源
+│   ├── attachments/        # 附件
+│   ├── clients/            # 客户端工程
+│   ├── docker/             # Docker 相关配置
+│   ├── docs/               # 文档
+│   ├── projects/           # 子项目
+│   └── stack/              # 部署栈
+└── .agents/                # 智能体协作资源（rules 零散规则 + skills 场景技能）
+```