diff --git a/skills/README.md b/skills/README.md index 461dda61..b9a37425 100644 --- a/skills/README.md +++ b/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 ## 配置