在trae skill描述中须精确声明输入字段名及类型、输出结构与默认值，并提供真实请求-响应示例，同时注明认证要求，否则ai无法正确解析导致调用失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Trae Skill中填写描述时，必须让AI准确理解该技能的输入格式、处理逻辑和输出结构，否则调用时会返回空值或格式错误。描述不是写作文，不能笼统说“处理用户问题”，而要精确到字段名、数据类型、边界条件和典型示例。
明确技能的输入与输出结构
第一步：打开Trae后台 → 进入Skill管理页 → 点击目标Skill右侧【编辑】按钮 → 滚动到「描述」文本框。
第二步：在描述开头用一行写清输入参数，格式为：【输入】 字段名（类型），例如：【输入】 user_id（字符串），query（字符串），max_results（整数，默认5）。
第三步：紧接着另起一行写【输出】，明确返回字段及嵌套关系，例如：【输出】 items（数组），其中每项含title（字符串）、score（浮点数）、url（字符串）；若无结果，返回空数组而非null。
这一步漏掉默认值或类型说明，AI可能把max_results当字符串解析，导致接口报错。
用真实请求-响应对说明行为边界
方法一：在描述末尾添加「示例」区块，直接粘贴一条真实curl请求和对应JSON响应（删减敏感字段后）。
方法二：用自然语言写两个最小可行案例，比如：“当user_id='U123'且query='天气'时，返回前3条气象资讯；当query为空字符串时，返回HTTP 400错误并提示'query cannot be empty'。”
【注意】 示例必须与你实际API返回完全一致，包括字段大小写、嵌套层级、空值表示方式（[] vs null），Trae会据此做schema推断。
避免常见描述陷阱
不要写“支持多种查询方式”——Trae不识别模糊表述。
不要用“大概”“可能”“通常”这类词，AI会忽略整句。
如果技能依赖外部认证头（如X-API-Key），必须在描述中写明：【认证】 请求需携带X-API-Key头，值为平台生成的密钥。
