如何编写一个高质量的智能体技能？

1. 撰写清晰且具体的 description

description 是智能体发现阶段唯一可见的信息，应写明功能与使用场景，并嵌入能帮助匹配任务的关键词，避免过于笼统。

2. 使用明确的步骤化指令

正文以编号步骤组织，比模糊段落更利于智能体可靠执行；为关键步骤标注预期输出。

3. 用 allowed-tools 收敛权限

只读分析类技能不应拥有写文件或执行命令的权限，通过预授权工具列表最小化技能的能力边界。

4. 内置错误处理与回退

在指令中说明异常时的处理、回退路径与清晰的错误提示，提升执行健壮性。

5. 将长内容拆分到 references

风格指南、API 规范、架构文档等放入 references 目录，保持主 SKILL.md 精简，仅在需要时加载。

6. 以评测驱动迭代

在代表性任务上运行技能、观察能力缺口并据此修订，是持续改进技能质量的有效方式。