什么值得买App下载 App ›
连续签到专享现金活动

Agent Skill触发率翻倍的秘密:动作+场景+关键词三件套

Agent Skill七成命中的命门,就卡在description这一行
Description是触发开关,不是功能介绍
Agent启动时只加载name加description["name + description会参与匹配","description是技能触发的唯一凭据"],正文压根不看["name 和 description 会参与匹配,正文内容 触发后才会加载"]。这意味着你写再多执行步骤,触发不了就是一堆废代码。description的任务只有一个:让AI判断“这活儿我接”。["description是技能触发的唯一凭据,正文指令、脚本逻辑、资源文件均不参与触发判断"]12
写description的正确姿势:动作加场景加关键词,三件套缺一不可。["好的description写法:功能完整 + 场景明确 + 触发条件清晰"]反面教材满大街都是——“处理Excel和CSV文件”["禁止只写「技能能做什么」"],这种写法AI根本不知道什么时候该出手。改成“当用户提到Excel、表格分析、数据清洗、财务报表统计时触发”["推荐(功能完整 + 场景明确 + 触发条件清晰)"],触发率直接翻倍。2
SKILL.md的结构要分两层,不能堆在一起
Frontmatter层["Frontmatter(元信息)决定 Skill 的「身份」和「权限」"]只放name和description,其他字段都是噪音["YAML 前置元数据字段 字段必填约束与说明 name是1-64 字符"]。name必须是小写连字符["name是1-64 字符,仅允许小写字母、数字和连字符"],最长64字符["name 最长 64 字符"], 超长AI直接截断。description控制在500字符以内["description 超过了 1024 字符的硬限制"], 写多了触发匹配反而乱["description 超过了 1024 字符的硬限制"]。34
正文才是执行质量的保障。["Skill 是否好用,才取决于正文"]放什么?放AI不知道的东西["Skill 里要写的是 Agent 原本不知道、或者容易做错的东西,而不是把模型本来就知道的常识重新讲一遍"]。项目特定约定、领域专用流程、非明显边缘情况、推荐工具链["只添加代理不知道的内容:省略通用知识,专注于项目特定约定、领域特定流程、非明显边缘情况和推荐工具"]。记住:正文平时不加载,只有触发后才吃进上下文,token消耗是触发时的成本,不是常驻负担["平时只占少量上下文(仅 name + description),只有真正用到时才加载完整内容"]。567
技能粒度要像函数,别做成瑞士军刀
一个Skill只封装一个可组合的工作单元。["设计连贯的技能单元:技能范围应类似函数,封装一个可组合的工作单元"]过窄要多个Skill协同,过宽触发时塞一堆无关内容进去["避免过窄(需多个技能协同)或过宽(难以精准触发)"]。判断标准是什么?["根据任务脆弱性匹配具体度"]脆弱任务给精确命令["脆弱任务(如数据库迁移):给出精确命令和执行顺序,禁止修改"],灵活任务说检查要点["灵活任务(如代码评审):说明检查要点而非固定步骤,解释指令背后的目的"]。别让AI在“要不要触发”这件事上还要猜你心思["提供默认值而非菜单:当有多个可选工具时,指定一个首选工具,仅简要提及替代方案"]。3
Gotchas是正文里最值钱的一段。["陷阱(Gotchas)部分:列出代理容易犯的具体错误,这是技能中价值最高的内容"]写清楚AI容易踩的坑,比如“users表使用软删除,查询必须包含WHERE deleted_at IS NULL”["列出代理容易犯的具体错误"]。这一步做好了,调试成本直接砍半["把失败路径写进规范:优秀 Skill 不只定义成功路径,还要定义失败回退"]。缺文件怎么补、权限不足怎么提示、审核驳回怎么修["缺文件怎么补、权限不足怎么提示、审核驳回怎么修"],失败路径定义清楚比成功路径更重要。38
常见问题避坑指南
  • Description写太长或太短。超过1024字符硬限制会被截断,太短又触发不了。建议控制在200-500字符,包含功能、场景、关键词三要素。4
  • 把常识写进正文。Skill里写“什么是PDF”这种内容,纯属浪费token。AI本来就知道的东西,不需要教。6
  • 测试指令过于简单。“帮我处理文件”这种请求不会触发Skill。必须用多步骤、有约束、有格式要求的复杂指令来测试。2
  • Name用了大写或特殊字符。必须全小写加连字符,不一致会导致加载失败。3
  • 技能粒度没把握好。一个Skill干太多件事,触发时上下文爆炸;干太少件事,又要组合调用增加复杂度。3

评论

评论区空态插画

当前文章无评论,是时候发表评论了