第四节：从零起跑——你的第一个Hello World Skill

引言上一章我们成功搭建了开发环境激活了AI助手就像为赛车加满了油、铺好了赛道。现在是时候点火启动完成你的第一次“极速跑圈”了。本章我们将抛开所有复杂概念用最少的代码构建并运行你的第一个Skill体验从想法到AI响应的完整闭环。核心理论一个最简Skill的生命周期可以抽象为四个清晰阶段加载开发者在IDE中定义Skill如编写一个YAML配置文件或Python脚本系统将其识别并注册为一个可用的“工具”。触发用户通过自然语言指令或点击面板按钮明确调用该Skill。系统解析指令匹配到对应的Skill定义。执行系统将用户输入参数与Skill内部逻辑核心是Prompt模板结合构造出完整的请求发送给大语言模型LLM。响应LLM根据请求进行计算生成结果如一段摘要文本系统将该结果格式化后返回给用户界面。这个过程就像一个自动咖啡机你选择“美式咖啡”触发机器读取预设的水量、粉量程序加载执行冲泡执行最后递给你一杯咖啡响应。我们的第一个Skill就是编写这个“冲泡程序”。实战演练我们的目标是创建一个“文本摘要提取器”。它接收用户输入的一段长文本并返回一个简洁的摘要。Step 1: 在Trae IDE中创建Skill文件在项目工作区右键选择“新建文件”。将文件命名为summarizer.skill.yml(.skill.yml是Trae中Skill的一种常见定义格式)。Step 2: 编写Skill定义打开summarizer.skill.yml文件输入以下内容# summarizer.skill.yml# 这是一个最简单的文本摘要Skill定义name:text_summarizer# Skill的唯一标识名description:提取输入文本的核心摘要生成简洁概括。# 对Skill功能的自然语言描述# 定义Skill的输入参数这决定了用户需要提供什么inputs:-name:long_text# 参数名description:需要被摘要的长篇文本内容# 参数描述用于引导用户输入required:true# 此参数是否为必填项type:string# 参数类型这里是字符串# Skill的核心执行模板。这里使用简单的Prompt工程。execution:template:|你是一个专业的文本摘要助手。 请对用户提供的文本进行摘要要求摘要简洁、准确保留核心事实与结论。用户文本{{long_text}}请直接输出摘要内容不要添加“摘要”等前缀。# 关键{{long_text}} 是一个变量插值运行时会被用户输入的实际文本替换。# 定义输出格式这里我们直接输出LLM返回的文本output:type:stringStep 3: 加载并触发Skill加载保存YAML文件后Trae IDE通常会自动检测并加载该Skill。你可以在侧边栏的“技能”或“工具”面板中看到新出现的text_summarizer。触发在Trae的AI对话主面板中你可以直接输入自然语言指令例如“请使用text_summarizer技能帮我摘要一下这段文字这里粘贴你的长文本”Step 4: 查看执行与响应当你发送上述指令后Trae会识别出你要调用text_summarizer并发现需要参数long_text。它会将你指令中引号内的文本块赋值给long_text参数。系统将long_text的值替换到execution.template中的{{long_text}}位置形成最终的Prompt发送给LLM。稍等片刻你就能在对话记录中看到LLM生成的文本摘要。动手试试找一段新闻或技术文章复制到上述指令的括号中体验完整的流程。避坑指南/高阶技巧参数提取失败如果输入指令后Skill没被正确触发可能是因为系统没从你的自然语言中成功提取出long_text参数。技巧在初期可以尝试使用更结构化的触发方式。例如在Trae中可能存在“技能测试面板”你可以直接在对应参数的输入框里粘贴文本这能确保参数被准确传递。Prompt不够“鲁棒”我们当前的Prompt非常简单如果用户输入的是代码、列表等特殊格式文本摘要效果可能不稳定。技巧在Prompt中增加更明确的指令或格式约束例如“无论输入文本格式如何你的摘要都必须是连贯的段落。”YAML格式错误YAML对缩进必须是空格不能是Tab和冒号后的空格非常敏感。编辑时建议开启编辑器的“显示空白字符”功能。技巧可以使用在线YAML校验工具或利用Trae IDE可能提供的配置校验功能确保文件格式正确。利用系统变量除了用户输入的参数Skill定义中还可以引用一些预定义的系统变量如{{current_date}}当前日期让你的Prompt上下文更丰富。具体支持哪些变量需查阅对应平台的文档。本章小结恭喜你已经成功跨越了从0到1的关键一步。本章我们深入理解了Skill“加载-触发-执行-响应”的生命周期并亲手创建了一个功能完整的文本摘要Skill。你掌握了Skill定义文件YAML的基本结构特别是inputs定义参数和execution.template编写核心Prompt这两个最关键的组成部分。记住一个有效的Skill 明确的输入边界 清晰的执行指令。在下一章我们将以此为基石探索如何通过更精巧的Prompt工程和流程控制让你刚刚诞生的Skill变得更“聪明”、更强大。