课程章节介绍
同学们，今天我们来聊聊怎么用 `sf agent generate agent-spec` 这个命令来生成代理的规范文件。这相当于给你的 Agent 起草一份详细的“简历”，告诉系统它是什么类型、代表哪家公司、扮演什么角色、说话用什么语气。
运行命令之后，它会跟你互动，一个个问你这些问题，你按提示回答就行。最终命令会帮你生成一个 YML 文件，这个文件分成两大部分：最上面是代理的基本属性，就是刚才你填的那些信息；下面呢，是大语言模型自动帮你列出来的“子代理”列表——相当于把大代理的任务拆分成更细的小代理。
不过，第一次生成的子代理有时不够精准。想要拿到最佳结果，一定要学会“调试迭代”。你可以加一个叫 `--spec` 的标志，然后指向你刚才存的 YML 文件，这样命令就会在现有文件的基础上继续优化，而不是从头再来。每次只重点微调上面的代理属性，描述得越清晰、越具体，下面 LLM 给出的子代理列表就越好。
还有个实用的小技巧：在子代理的描述里面，你可以用自然语言直接加上一些提示。比如告诉它“请使用某个特定操作”，这样大模型就知道按你的意图去组合动作了。相当于你在悄悄给它一些内部的指导。
最后，在整个迭代过程中，别只盯着命令窗口。你可以在 VS Code 里随时手动打开 YML 文件，直接编辑上面的属性、或者调整子代理的描述，保存后再用 `--spec` 跑一遍命令。这样一步一打磨，做出来的代理规范就会越来越贴合你的业务需求。好，这一页的关键点就这些，大家可以动手试一下。