手写skill需要注意的地方很多，那么有哪些地方容易踩坑呢？下面就盘点手写skill容易踩坑的地方，看看如何才能不踩坑。
手写skill有哪些容易踩坑的地方
手写 Skill 很适合理解原理，但也容易踩坑。
1. description 太宽泛
错误示例：
description: 写作助手
这个描述几乎什么都能触发，边界太宽。
更好的写法：
description: 撰写、润色或整理中文工作总结类文档时使用，包括周报、双周报、月报、季度总结、半年/年度总结、项目复盘、阶段性汇报、述职报告、工作小结等。当用户说"帮我写个周报"、"整理一份月度工作"、"年终总结"、"项目复盘"、"做汇报材料"、"述职"，或扔过来一堆零散工作记录要求"总结一下"、"整理成报告"时，都要主动启用。该技能用于帮助用户把零散工作内容整理成结构清晰、重点明确、表达正式自然的总结文本。
2. 只写原则，不写步骤
错误示例：
## 要求
写得专业、自然、有深度。
更好的写法，是把“专业”拆成动作：
- 先判断总结范围。
- 再提炼核心工作。
- 然后整理成果。
- 接着写问题与不足。
- 最后写经验和计划。
3. 把所有东西都塞进 SKILL.md
SKILL.md 最好保持精简。
内容越来越长时，通常就该拆了：
- 长规范放
references/。 - 重复操作放
scripts/。 - 模板素材放
assets/。
4. 没有写反例和禁区
很多输出问题，不是 AI 不知道该做什么，而是不知道什么不能做。
例如工作总结里必须明确：
- 不要虚构数据。
- 不要写口号。
- 不要把小问题写成严重事故。
- 不要为了凑字数重复表达。
限制写得越清楚，输出越稳定。
上述就是手写skill有哪些容易踩坑的地方的全部内容，希望对大家手写skill提供了帮助，如果想要了解更多skill相关内容，欢迎来CoCoLoop社区交流。