agent skills技能文件通常由yaml头部和markdown正文组成，文件名必须是skill.md。头部提供标准要求的名称和用途描述，正文告诉ai怎样处理任务。写作时先保证字段格式正确，再补充清楚的步骤、输出示例和资源读取条件。
先写标准YAML头部
文件开头与头部结尾各用单独一行---分隔。name和description是标准必填字段，例如name: meeting-summary，description写明整理会议记录的用途及适用时机。
name为1至64个字符，建议用小写英文字母、数字和短横线，不能以短横线开头或结尾，不能有连续短横线，并与目录名一致。description非空且不超过1024个字符。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
正文写成可执行的任务说明
在头部之后，用Markdown小标题组织输入、步骤和输出。步骤写具体动作，例如“提取已确认决策，按待办、负责人、截止时间整理”，少用“认真处理”等空泛要求。
补上缺失输入和常见异常的处理方法，再给一组简短输入输出示例。纯文字技能可以不带脚本；正文过长时，把详细资料拆出去，并写清何时读取。
使用相对路径并检查格式
引用资料用相对技能根目录的路径，例如references/规则.md；需要脚本时写明scripts/文件名及参数。避免只说“看附件”，也不要串接多层不清楚的引用。
可用标准参考工具skills-ref validate ./meeting-summary检查头部和命名；使用前需准备该工具。格式通过后仍要在目标宿主试用，分别验证能否调用、步骤是否执行、输出是否符合要求。
