用途：该技能帮助创建 VS Code 自定义智能体文件（.agent.md），定义面向开发任务的专用 AI 角色。自定义智能体可配置可用工具、提供专门指令，并通过 handoffs 串联成多步工作流。
适用场景：从零创建新自定义智能体；脚手架化带正确 frontmatter 的 .agent.md 文件；设置智能体间交接以支持多步工作流；为专用角色（如 planner、reviewer）配置工具限制；创建工作区共享或用户配置级智能体。不适用于创建指令文件（应使用 .instructions.md）、可复用提示（应使用 .prompt.md）或修改已有智能体（直接编辑文件即可）。
主要能力与用法：在 agents/ 目录下创建 agents/<agent-name>.agent.md 文件，并添加 YAML frontmatter。必填字段为 description；可选字段包括 name、argument-hint、tools、agents、model、handoffs、user-invokable、disable-model-invocation、target、mcp-servers。工具可写内置工具（如 search、fetch）、工具集（如 codebase）或 MCP 服务器通配（如 myServer/*）。handoffs 支持 label、agent、prompt、send、model 字段。正文用 Markdown 编写角色、指南、工作流与约束，可用 Markdown 链接引用其他文件，用 #tool:<tool-name> 引用工具。
验证与限制：可通过命令面板运行“Chat: New Custom Agent”或查看智能体下拉列表，并用 Diagnostics 视图检查错误。常见问题包括文件位置或扩展名错误、YAML 语法错误、工具名不存在、交接目标智能体不存在、指令过于模糊等。资料未提供收费、价格或平台支持范围等信息。