From ef33bfc2e3016febb4cf3867d9e379a1d8c13dbe Mon Sep 17 00:00:00 2001
From: 8ga <jkwlstv@outlook.com>
Date: Fri, 24 Jul 2026 12:00:02 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20a2s=5Fagent=5Farch.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 a2s_agent_arch.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/a2s_agent_arch.md b/a2s_agent_arch.md
index cae9be9..4e4f366 100644
--- a/a2s_agent_arch.md
+++ b/a2s_agent_arch.md
@@ -109,6 +109,33 @@ com\lcfc\agent\scope\
 └── KbSearchCtl.java                          # 知识库搜索控制类
 ```
 
+### 管理Skill
+
+```text
+com\lcfc\agent\skills\
+├── BaseSkillToolsExecutor.java               # 执行Skill中的脚本工具类父类
+├── AgentScopeSkillTools.java                 # 基于agentscope-java封装执行Skill中脚本的Tools
+├── SpringAiSkillTools.java                   # 基于spring-ai封装执行Skill中脚本的Tools
+├── AgentSkillMetadataHandler.java            # 在磁盘文件记录存储了多少个Skill,包括技能ID和名称
+├── AgentSkillResourceHandler.java            # 负责Skill静态资源的下载、解压、删除
+├── AgentSkillRuntimeHandler.java             # 每个会话都会拷贝用到的Skill资源到临时目录,该类负责临时目录的创建与删除
+├── AgentSkillRuntimeConfigHandler.java       # Skill包含自定义配置,该类管理运行时自定义配置的创建、读取、删除
+├── AgentSkillSessionCache.java               # 管理智能体运行时SKill临时目录,包括自动续期与超时,超时会自动清理,避免磁盘空间浪费
+├── RemoveSkillConsumer.java                  # 处理智能体解绑了某个skill的事件/服务端Skill资源被删除事件
+├── SkillRemoveConsumer.java                  # ？
+├── SkillResourceChangeConsumer.java          # 处理Skill资源更新事件
+├── SkillStateChangeConsumer.java             # 处理Skill状态变更事件(禁用/启用)
+├── AgentSkillRuntimeConfig.java              # 智能体运行时Skill配置，例如：临时目录的根目录、过期时长等
+└── AgentSkillResourceConfig.java             # Skill资源配置，例如：静态资源的根目录、最多存放的静态资源数量等
+```
+
+### 公共工具包
+
+```text
+com\lcfc\agent\utils\
+└── TransactionTaskTemplate.java             # 编程式Spring事务模板
+```
+
 ### 项目数据统计相关
 
 ```text