HoRain 云小助手个人主页⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。目录⛳️ 推荐Description 的作用与限制Description 的四要素结构常见的 Description 写法问题用自动化工具优化 Description第一步准备测试用例实例第二步运行优化循环实例第三步应用最优结果实例A/B 对比测试实例description 字段是 Skill 触发的唯一判断依据。一个写得好的 description能让 Skill 在正确的时机被触发并避免在不相关的场景下干扰 Claude。Description 的作用与限制Claude 在决定是否使用某个 Skill 时只会阅读 description 字段不会提前读取 SKILL.md 正文。这意味着 description 需要同时承担两件事说明 Skill 能做什么以及指明何时应该用它。description 的理想长度是 50-150 字。太短会导致触发不准确太长则可能超出上下文限制且 Claude 难以快速扫描比对。Description 的四要素结构要素作用示例核心功能一句话最直接地说明 Skill 是什么处理 Excel 和 CSV 格式的表格数据具体能力列举列出 3-5 个典型操作包括数据清洗、统计分析、图表生成触发场景描述告诉 Claude 什么时候应该用当用户提到数据分析、报表、统计时触发推动性语句可选解决低触发率问题即使用户没有明确提到格式只要涉及表格数据就应使用--- name:>常见的 Description 写法问题问题示例错误修正方向只写功能不写触发场景分析数据的工具补充当用户……时触发描述过于宽泛处理文件的通用工具列举具体文件类型和操作使用 Skill 内部实现术语调用 pandas 进行分析改为用户视角的业务描述与其他 Skill 边界不清两个 Skill 都写处理文档明确区分各自的文件类型或操作类型用自动化工具优化 Descriptionskill-creator 提供了 description 自动优化脚本通过迭代测试找出触发率最高的写法。第一步准备测试用例实例[{id: should_trigger_01,prompt: 帮我分析 runoob_sales.csv找出月度销售趋势,expected: true,note: 典型的数据分析请求},{id: should_trigger_02,prompt: 这个 Excel 文件里哪些列有空值帮我统计一下,expected: true,note: 涉及数据质量检查},{id: should_not_trigger_01,prompt: Excel 和 CSV 有什么区别,expected: false,note: 知识问答不需要 Skill},{id: should_not_trigger_02,prompt: 帮我写一封邮件,expected: false,note: 完全无关的任务}]第二步运行优化循环实例# 运行 description 自动优化# 脚本会自动评估 → 修改 → 再评估循环 5 次python -m scripts.run_loop \--eval-set evals/trigger-eval.json \--skill-path>第三步应用最优结果实例# 脚本输出 best_description 字段将其替换到 SKILL.md 的 description 中# 优化前grep description:>A/B 对比测试在不确定哪种写法更好时可以对两个版本的 description 进行盲测对比。实例# 版本 A当前的 description# 版本 B候选的新 description# 分别运行评估python -m scripts.run_eval \--eval-set evals/trigger-eval.json \--skill-path />❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧