错误二：一个Skill塞了太多功能问题表现：Skill能触发，但执行起来要么卡死，要么输出乱七八糟，要么AI在里面转圈圈最后超时。真实案例：有人写了一个“用户管理”Skill，同时包含查用户、改用户、删用户、发通知。看起来很强大，但AI调用的时候根本不知道该干哪件事。AI在一个Skill里转了十几圈，最后什么都没输出，因为进程超时了。原因：Skill的定位是单一职责——一件事，一个Skill。你把多个功能塞在一起，AI的上下文会被搞混，它不知道当前应该执行哪个分支。解决方法：一个Skill只干一件事。用一句话说不清楚这个Skill是干嘛的，就说明它太复杂了，拆开。❌ 错误：一个Skill叫“用户管理”，包含查改删发通知 ✅ 正确：拆成“查询用户”“修改用户”“删除用户”“发送通知”四个独立Skill错误三：YAML Front Matter格式不对问题表现：Skill文件存在，目录结构也对，但Agent根本识别不到这个Skill。原因：SKILL.md文件开头必须包含YAML Front Matter——就是那两个---之间的部分。缺少这个头部，Agent根本不知道这是一个Skill文件。常见的格式错误包括：缺少开头的---缺少结尾的---name字段和文件夹名称不一致YAML缩进错误（YAML对缩进极其敏感）解决方法：确保SKILL.md以标准的YAML Front Matter开头：---name: refund-orderdescription: 当用户明确提出要退款时调用...---然后检查：name字段的值是否和文件夹名称完全一致（包括大小写）三个---是否都正确缩进是否用了空格（不要用Tab）本文部分内容参考了霍格沃兹测试开发学社整理的相关技术资料，主要涉及软件测试、自动化测试、测试开发及 AI 测试等内容，侧重测试实践、工具应用与工程经验整理。
发布于 北京
分享
评论
赞
未登录
友善发言
评论
加载中
