发布日期：2026-05-27 09:49:33 浏览次数： 1765
作者：李举刚
微信搜一搜，关注“李举刚”
推荐语
精简Skill描述让Agent更聪明，40词以内精准调用，避免token浪费与选择错误。
核心内容：
1. Skill描述过长导致Agent调用错误的三大原因
2. 实际案例：压缩描述后调用准确率显著提升
3. 核心原则：为模型提供“路标”而非“说明书”
杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家
很多人在给Agent写Skill描述时，默认一个前提。写得越详细，Agent越容易理解。
这套思路在人类协作里没问题，可一旦换成模型，情况完全反过来。
很多Agent选错技能、反复调用、token越烧越多，其实都卡在同一个地方。Skill写太长。
一个开发者分享过一个很典型的例子。
他给某个Skill写了90词描述，逻辑很完整，像一段小说明书。结果Agent老是选错技能。
后来他干脆把描述砍到40词以内，只保留最核心的动作词。
结果第一次调用就选对了。
很多人看到这个案例的第一反应是惊讶。
但如果你真的做过Agent系统，很快会意识到，这事一点不奇怪。
## 1
很多Agent开发者把Skill.md当文档写。
问题就从这里开始。
Skill描述一旦写长，就会同时触发三件事。
token成本增加、选择噪声增加、注意力被稀释。
先说最现实的一件事，钱。
Skill描述本身就在上下文里。
多写一句话，Agent每次运行就多读一次，多算一次token。
只要这个Skill被频繁加载，你就在持续付费。
再看上下文预算。
GPT-5.5默认上下文窗口是272k token。
听起来很多，对吧。
但真正分配给技能描述的预算只有2%。
注意，是所有Skill一起分这2%。
如果你的系统有几十个Skill，很容易就把预算挤满。
一旦超过限制，模型会截断技能描述。
很多人以为自己写得很清楚。
模型看到的版本其实已经被截断。
第三个问题更隐蔽。
选择噪声。
Agent在决定调用哪个Skill时，会同时扫描所有Skill描述。
描述越长，信息越杂，判断信号就越模糊。
你写了一堆解释性文字。
模型只需要几个动作词。
结果就是。
真正关键的信息被淹没。
Codex内部的计费逻辑也很直接。
严格按UTF8字节数除以4向上取整计算token。
写长一句话，看起来没什么。
运行几万次之后，就是一笔真实的成本。
所以很多团队后来才意识到。
Skill描述越长，系统越慢，钱烧得越快。
## 2
我印象里有个挺典型的案例。
一个做Agent开发的大厂P7工程师，技术方向是自动化运维。他在内部做工具链，把十几个运维操作封装成Skill。
每个Skill的描述都写得很认真。
几十到一百词不等。
上线以后问题马上出现。
Agent经常调用错技能。
比如需要deploy的时候，跑去执行inspect。
需要verify时，又去调用release。
团队开始怀疑模型能力。
后来他们做了一件很简单的事。
把Skill描述全部压缩。
平均长度从接近90词降到40词以内。
保留动作词，删掉解释句。
deploy
release
verify
debug
inspect
fix
上线测试之后，调用准确率直接明显提升。
那位工程师后来复盘时说了一句挺有意思的话。
模型其实不需要说明书，它只需要路标。
说实话，这种情况挺常见的。
这事跟你写代码水平没太大关系，很多工程师第一次做Agent都会踩这个坑。
因为人类写文档的习惯，很难一下子改过来。
## 3
有个做法在Agent圈子里越来越多人用。
Peter的skill-cleaner就是典型例子。
Peter也叫steipete，很多人认识他的原因是那套agent-scripts工具。
他在设计skill-cleaner时做了一个很极端的选择。
Skill.md只有56行提示词。
真正干活的脚本接近近千行代码。
提示词只干一件事。
让Agent找到这个能力。
具体逻辑、异常处理、边界情况，全写在代码里。
Peter自己总结这套方法时说得很直白。
install skill
agent smart
user happy
很多人第一次看到这种写法会觉得太简单。
但实际跑起来反而很稳定。
原因很简单。
Skill描述只承担定位功能。
真正的执行逻辑在脚本。
skill-cleaner的设计思路也围绕这一点展开。
它会先扫描你的技能库，然后做一轮完整体检。
第一个模块是技能提示词预算审计。
脚本会计算所有Skill描述占用多少上下文预算，并给出优化建议。
第二个模块是重复技能检测。
它会同时扫描几个来源。
Codex内置库
插件缓存
代码仓库
个人技能根目录
如果出现重复Skill，会标出来。
第三个模块是未使用技能筛查。
脚本会读取历史日志，找出长期没被调用的Skill。
第四个模块是技能根目录审计。
系统会统计每个Skill来自哪个目录，同时标记启用或禁用状态。
第五个模块是描述精简优化。
脚本会找出冗长描述，然后用短动作词进行替换。
比如调试类Skill。
推荐统一动作词。
debug
inspect
fix
部署类操作。
deploy
release
verify
检索类操作。
search
sync
summarize
这些词非常短。
但模型识别效率反而更高。
整个脚本内部使用的预算计算逻辑，和Codex官方源码一致。
也就是UTF8字节数除以4向上取整。
脚本还能模拟真实运行环境。
如果预算不足，会直接告诉你。
多少字符被截断
多少技能会被省略
以及当前预算使用率、剩余预算、上下文占用比例。
很多团队跑完第一次报告都会吓一跳。
原来Skill描述已经把上下文预算吃掉一大块。
## 4
如果你现在在做Agent系统，其实可以立刻给自己的Skill做一次体检。
skill-cleaner就在GitHub上。
地址是 github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner
整个流程很简单。
第一步。
在技能目录或者仓库根目录运行Node.js脚本。
脚本支持很多参数，比如时间范围、日志深度、预算阈值、技能根目录路径。
第二步。
看报告。
一般建议按这个顺序看。
技能预算
描述优化项
重复技能
未使用技能
根目录汇总
第三步。
再做清理。
有几个经验比较重要。
Codex内置技能尽量保留。
本地副本如果重复，可以删掉。
仓库里核心运维Skill建议留着。
它们通常和项目环境绑定。
还有一点很多人会忽略。
不要直接删目录。
先确认这个Skill确实没有被任何脚本调用。
描述精简也有个简单流程。
先做文本预处理。
统一格式，全部小写，去掉多余标点。
再用关键词识别场景。
判断是调试、部署还是检索。
最后替换成标准短动作词。
这样一轮下来，大多数Skill描述都能明显变短。
很多人做完这一步都会发现一个问题。
之前写的那些长描述，几乎没有提高任何效果。
只是让上下文更拥挤。
## 5
如果你现在正在维护一套Agent系统，可以先做三件事。
1 把所有Skill描述统计一遍长度。
超过40词的先标出来。很多问题就在这些地方。
2 跑一遍skill-cleaner。
重点看技能预算占比和未使用技能报告。
3 把描述里的解释句删掉，只留下动作词。
debug、deploy、search这类词往往就够了。
别慌。
Agent开发的很多坑，其实都在这些细节里。
Skill写短一点。
系统反而更聪明。
[登录查看剩余 70% 内容](javascript:void (0);)
https://www.53ai.com/keyword/AI%20skillhttps://www.53ai.com/keyword/skill%E6%98%AF%E4%BB%80%E4%B9%88https://www.53ai.com/keyword/skill%E6%98%AF%E5%B9%B2%E5%98%9B%E7%9A%84
分享：
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
53AI，企业落地大模型首选服务商
**产品**：场景落地咨询+大模型应用平台+行业解决方案
**承诺**：免费POC验证，效果达标后再合作。**零风险落地应用大模型**，已交付160+中大型企业
https://www.53ai.com/news/tishicikuangjia/2026052871869.htmlhttps://www.53ai.com/news/tishicikuangjia/2026052783095.html
https://www.53ai.com/news/tishicikuangjia
相关资讯
https://www.53ai.com/news/tishicikuangjia/2026070413704.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070265741.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070124357.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070107258.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070103254.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070174326.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070129317.htmlhttps://www.53ai.com/news/tishicikuangjia/2026070119702.html
https://www.53ai.com/solution.html
https://www.53ai.com/solution.html
160+中大型企业正在使用53AI
[立即咨询](javascript:void(0))[预约演示](javascript:void(0))
https://www.53ai.com/news/dongtai/2025012294502.htmlhttps://www.53ai.com/news/dongtai/2025012234192.html
https://hub.53ai.com/
热点资讯
https://www.53ai.com/news/tishicikuangjia/2026051597542.htmlhttps://www.53ai.com/news/tishicikuangjia/2026052409782.htmlhttps://www.53ai.com/news/tishicikuangjia/2026041683796.htmlhttps://www.53ai.com/news/tishicikuangjia/2026041412039.htmlhttps://www.53ai.com/news/tishicikuangjia/2026040910685.htmlhttps://www.53ai.com/news/tishicikuangjia/2026050695647.htmlhttps://www.53ai.com/news/tishicikuangjia/2026051925938.htmlhttps://www.53ai.com/news/tishicikuangjia/2026052072043.htmlhttps://www.53ai.com/news/tishicikuangjia/2026050320581.htmlhttps://www.53ai.com/news/tishicikuangjia/2026041447532.html
大家都在问
https://www.53ai.com/news/tishicikuangjia/2026062898431.htmlhttps://www.53ai.com/news/tishicikuangjia/2026062374293.htmlhttps://www.53ai.com/news/tishicikuangjia/2026061129743.htmlhttps://www.53ai.com/news/tishicikuangjia/2026061135916.htmlhttps://www.53ai.com/news/tishicikuangjia/2026060924810.htmlhttps://www.53ai.com/news/tishicikuangjia/2026060882139.htmlhttps://www.53ai.com/news/tishicikuangjia/2026052871869.htmlhttps://www.53ai.com/news/tishicikuangjia/2026051950942.html
热门标签
https://www.53ai.com/news/neirongchuangzuohttps://www.53ai.com/news/LargeLanguageModelhttps://www.53ai.com/news/gerentixiaohttps://www.53ai.com/news/langchainhttps://www.53ai.com/news/llamaindexhttps://www.53ai.com/news/MultimodalLargeModelhttps://www.53ai.com/news/RAGhttps://www.53ai.com/news/zhinengkefuhttps://www.53ai.com/news/knowledgegraphhttps://www.53ai.com/news/finetuninghttps://www.53ai.com/news/RAGFlowhttps://www.53ai.com/news/cozehttps://www.53ai.com/news/difyhttps://www.53ai.com/news/fastgpthttps://www.53ai.com/news/Bishenghttps://www.53ai.com/news/Qanythinghttps://www.53ai.com/news/AIqichehttps://www.53ai.com/news/AIjinronghttps://www.53ai.com/news/AIgongyehttps://www.53ai.com/news/AIpeixunhttps://www.53ai.com/news/AISaaShttps://www.53ai.com/news/tishicikuangjiahttps://www.53ai.com/news/tishicijiqiaohttps://www.53ai.com/news/AIdianshanghttps://www.53ai.com/news/AImianshihttps://www.53ai.com/news/shuziyuangonghttps://www.53ai.com/news/zhinengbaobiaohttps://www.53ai.com/news/zhishiguanlihttps://www.53ai.com/news/OpenSourceLLMhttps://www.53ai.com/news/zhinengyingxiaohttps://www.53ai.com/news/zhinengyingjianhttps://www.53ai.com/news/zhinenghuagaizaohttps://www.53ai.com/news/AIyiliaohttps://www.53ai.com/news/MaxKBhttps://www.53ai.com/news/Palantirhttps://www.53ai.com/news/Gleanhttps://www.53ai.com/news/Openclaw
[应聘简历请发送至： ceo@53ai.com](mailto:ceo@53ai.com)
https://www.53ai.com/product.html
https://www.53ai.com/product/quanyuanAIhttps://www.53ai.com/product/gongzuoduihuahttps://www.53ai.com/product/neirongchuangzuohttps://www.53ai.com/product/zhinengwendanghttps://www.53ai.com/product/mofacaidan
https://www.53ai.com/product/yewuAIhttps://www.53ai.com/product/weixinfenshenhttps://www.53ai.com/product/haiwaikefuhttps://www.53ai.com/product/guanwangkefuhttps://www.53ai.com/product/douyinkefuhttps://www.53ai.com/product/shuzilaoshihttps://www.53ai.com/product/shuzidudaohttps://www.53ai.com/product/zhinengfuwutai
https://www.53ai.com/product/AIXyewuhttps://www.53ai.com/product/zhinengwenshuhttps://www.53ai.com/product/zhinengshenhehttps://www.53ai.com/product/zhinenggongdanhttps://www.53ai.com/product/qiweigenjinzhushouhttps://www.53ai.com/product/zhinengbaojiahttps://www.53ai.com/product/qiweixiaoshouzhushouhttps://www.53ai.com/product/zijianyingyonghttps://www.53ai.com/product/qiweikefuzhushou
https://www.53ai.com/consulting.htmlhttps://www.53ai.com/fine-tuning.html
https://www.53ai.com/kehuanli.html
https://www.53ai.com/kehuanli/hangyeanlihttps://www.53ai.com/kehuanli/solution
https://www.53ai.com/news.html
https://www.53ai.com/news/qianyanjishuhttps://www.53ai.com/news/agentplatformhttps://www.53ai.com/news/hangyeyingyonghttps://www.53ai.com/news/qiyejingyinghttps://www.53ai.com/prompt.html
https://www.53ai.com/about.html
https://www.53ai.com/about/introductionhttps://www.53ai.com/about/cooperation
友情链接：
https://www.waytoagi.com/https://www.yuncan.com/https://www.wescrm.com/https://www.mingpian.top/https://www.uweb.net.cn/
CopyRight © 2012-2026 深圳市博思协创网络科技有限公司 版权所有
https://beian.miit.gov.cn/
广州：广州市华景路37号(华景软件园)暨南大学科技大厦6楼（整层）
深圳：深圳市福田区泰然四路29号天安创新科技广场一期A座1204
上海：上海市浦东新区金新路58号1602室
微信扫码
和创始人交个朋友
联系我们
售前咨询
[186 6662 7370](tel:18666627370)
预约演示
[185 8882 0121](tel:18588820121)
微信扫码
添加专属顾问
回到顶部
加载中…
扫码咨询
[](https://www.53ai.com/news/tishicikuangjia/2026052742563.html)
https://work.weixin.qq.com/ca/cawcde2599cf74e2d9https://work.weixin.qq.com/ca/cawcdefb661890e885[电话咨询](tel:400-838-1185)
扫码登录
– [x] 登录即表示您同意[《53AI网站服务协议》](javascript:void(0);)
服务协议
欢迎您使用【53AI 官方网站】（以下简称“本网站”或“我们”）。本《会员服务协议》（以下简称“本协议”）是您（以下简称“会员”或“用户”）与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。
在您注册或登录前，请务必审慎阅读、充分理解各条款内容，特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时，即视为您已完全理解并同意接受本协议的全部内容。
一、 定义
本网站：指由【深圳市博思协创网络科技有限公司】运营的，域名为【53ai.com】的网站及相关移动端页面。
会员服务：指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。
知识库内容：指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。
二、 账号注册与登录
登录方式：本网站支持以下登录方式，您可根据实际情况选择：
微信公众号授权登录：您同意将您的微信OpenID信息授权给本网站，用于创建或关联会员账号。
手机验证码登录：您需提供真实有效的手机号码，并通过短信验证码完成身份验证与登录/注册。
账号安全：您的账号仅限您本人使用，禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失，由您自行承担。
实名认证：根据相关法律法规要求，我们可能要求您在特定功能下完成实名认证。如您拒绝提供，可能无法使用部分或全部服务。
未成年人保护：若您未满18周岁，请在法定监护人的陪同下阅读本协议，并在征得监护人同意后使用本服务。
三、 服务内容与规范
知识库查阅权限：会员登录后，有权按照其会员等级对应的权限范围，在线浏览、检索本网站知识库中的相关文章及内容。
服务变更：我们有权根据业务发展需要，调整、变更或终止部分服务内容，并将以网站公告、公众号消息等方式提前通知。
禁止行为：您在使用服务时不得实施以下行为：
利用技术手段批量爬取、下载、转存知识库内容；
将知识库内容用于商业目的或未经授权地向第三方传播；
干扰本网站正常运行或侵犯其他用户合法权益；
发布违法违规信息或从事违反公序良俗的活动。
四、 知识产权声明
权利归属：本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有，受《中华人民共和国著作权法》等法律保护。
有限许可：本网站授予会员一项非独占、不可转让、不可转授权的普通许可，仅限于个人学习、研究之目的在线查阅知识库内容。
侵权追责：未经书面许可，任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现，我们保留追究其法律责任的权利。
五、 个人信息保护
我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息，请单独阅读 《隐私政策》。
您通过微信公众号授权或手机号验证所提供的信息，我们将严格按照《个人信息保护法》的规定处理，仅用于身份识别、服务提供及安全验证等必要用途。
您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。
六、 免责声明
内容准确性：知识库内容仅供参考，不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证，您应自行判断并承担使用风险。
不可抗力：因自然灾害、政策法规变化、网络故障、第三方平台接口异常（如微信接口维护、运营商短信通道故障）等不可抗力导致的服务中断或延迟，我们不承担违约责任。
第三方链接：本网站可能包含指向第三方网站的链接，该等网站的内容和服务不受我们控制，请您自行甄别风险。
七、 违约责任
如您违反本协议约定，我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施，并保留要求赔偿损失的权利。
如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失，您应承担全部赔偿责任（包括但不限于罚款、赔偿金、律师费、公证费等）。
八、 法律适用与争议解决
本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。
因本协议产生的或与本协议有关的任何争议，双方应友好协商解决；协商不成的，任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。
九、 其他
本协议构成双方就本服务达成的完整协议，取代此前任何口头或书面约定。
本协议任一条款被认定为无效或不可执行的，不影响其他条款的效力。
我们对本协议享有最终解释权，并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效，继续使用服务即视为同意修订内容。
[已查阅](javascript:void(0);)
安全验证
拖动下方拼图完成验证
AI生成背景
您的速度已超过 99% 的用户
验证错误,请重试
确定
安全验证
刷新验证码
反馈
切换无障碍验证
切换常规验证
