Add files via upload

skills/README.md

@@ -2,7 +2,7 @@
 
 ## 概述
 
-Skills系统允许你为角色配置专业知识和技能文档。当角色执行任务时，系统会自动将这些skills的内容注入到系统提示词中，帮助AI更好地理解和执行相关任务。
+Skills系统允许你为角色配置专业知识和技能文档。当角色执行任务时，系统会将技能名称添加到系统提示词中作为推荐提示，AI智能体可以通过 `read_skill` 工具按需获取技能的详细内容。
 
 ## Skills结构
 
@@ -62,16 +62,16 @@ enabled: true
 
 ## 工作原理
 
-1. **加载阶段**：系统启动时，会扫描`skills_dir`目录下的所有skill
+1. **加载阶段**：系统启动时，会扫描`skills_dir`目录下的所有skill目录
 2. **执行阶段**：当使用某个角色执行任务时：
-   - 系统会加载该角色配置的所有skills
-   - 将skills内容合并并注入到系统提示词中
-   - AI在执行任务前会阅读这些skills内容
-3. **按需调用**：即使角色没有配置skills，AI也可以通过以下工具按需调用：
+   - 系统会将角色配置的skill名称添加到系统提示词中作为推荐提示
+   - **注意**：skill的详细内容不会自动注入到系统提示词中
+   - AI智能体需要根据任务需要，主动调用 `read_skill` 工具获取技能的详细内容
+3. **按需调用**：AI可以通过以下工具访问skills：
    - `list_skills`: 获取所有可用的skills列表
    - `read_skill`: 读取指定skill的详细内容
    
-   这样AI可以在执行任务过程中，根据实际需要自主调用相关skills获取专业知识。
+   这样AI可以在执行任务过程中，根据实际需要自主调用相关skills获取专业知识。即使角色没有配置skills，AI也可以通过这些工具按需访问任何可用的skill。
 
 ## 示例Skills
 
@@ -106,10 +106,12 @@ EOF
 
 ## 注意事项
 
-- Skill内容会被注入到系统提示词中，注意控制长度避免超过token限制
+- **重要**：Skill的详细内容不会自动注入到系统提示词中，只有技能名称会作为提示添加
+- AI智能体需要通过 `read_skill` 工具主动获取技能内容，这样可以节省token并提高灵活性
 - Skill内容应该清晰、结构化，便于AI理解
 - 可以包含代码示例、命令示例等
 - 建议每个skill专注于一个特定领域或技能
+- 建议在skill的YAML front matter中提供清晰的 `description`，帮助AI判断是否需要读取该skill
 
 ## 配置