Claude Code Skills 里我觉得最容易被低估的是 description。很多人会认真写正文，但 description 随手写一句，结果技能很难被正确触发。
不好的 description
description: A powerful skill for frontend development.
问题是太泛。模型不知道什么时候该加载，也不知道什么时候不该加载。
更好的 description
description: Implement or modify React frontend UI, then verify the result with browser screenshots across desktop and mobile viewports. Use when the user asks for visible UI changes.
这里包含了三件事：
- 做什么：React UI。
- 怎么做：截图验证。
- 什么时候用：visible UI changes。
description 写法模板
description: [Task type]. Use when [trigger condition]. Do not use when [exclusion condition].
比如代码审查可以这样写：
description: Review code diffs for correctness bugs and regression risk. Use when the user asks for review, PR check, or pre-merge validation. Do not use for general refactoring requests.
为什么排除条件有用
有些技能很容易误触发。比如 security-review，如果 description 太泛，模型可能每次改代码都进入安全审计模式，输出会变得很重。
可以写：
description: Use for authentication, authorization, secrets, dependency risk, and input validation reviews. Do not use for ordinary UI copy changes.
我的经验
Skill 的正文决定“怎么做”，description 决定“何时做”。
如果触发错了，正文写得再好也会打扰任务。
1 个帖子 - 1 位参与者
来源: LinuxDo 最新话题查看原文