Flutter 与 Dart 的 Agent Skills

本指南介绍如何使用 Agent Skills 为 AI 智能体与编程助手增强领域特定能力。

AI 智能体可以编写 Flutter 与 Dart 代码，但有时不了解专业开发者使用的工具与最佳实践。

Agent Skills 通过标准化方式为 AI 智能体提供面向任务的蓝图集合来解决这一问题。为智能体提供真正的领域专业知识与可重复工作流，可大幅减少错误并落实一致的模式。

要理解 Agent Skills 如何融入工作流，可将其与其他 AI 能力对比：

• 规则文件： 规则文件 配置智能体在所有任务中的一般行为，而 Agent Skills 为某一具体工作提供分步指令。

• Model Context Protocol (MCP)： Dart 与 Flutter MCP 服务器 为智能体提供专用工具访问。若 MCP 提供原始机制，Agent Skill 则提供正确操作该机制的专业知识。

Skills 使用我们称为「渐进式披露」的机制，类似 Flutter 中的延迟加载。智能体不会一次性将全部指令载入上下文窗口，而是先只读取元数据，仅在当前任务实际需要时才拉取详尽指令。

Dart 与 Flutter 团队维护面向本框架定制的官方 Skills 仓库。

• dart-lang/skills：提供 Dart 开发相关 skills。可用于生成单元测试、解决 package 依赖并修复静态分析错误。

• flutter/skills：提供 Flutter 开发相关 skills。这些 skills 帮助 AI 构建响应式布局、接入声明式路由并实现 JSON 序列化。

默认情况下，兼容的 AI 智能体会在项目工作区的 .agents/skills 目录中发现 Agent Skills。

要方便地下载并管理该文件夹中的 skills，可使用 skills CLI 工具。它通过 npm 分发，因此需要安装 Node.js 才能用 npx 运行。

安装官方 Flutter skills：

npx skills add flutter/skills --skill '*' --agent universal

安装官方 Dart skills：

npx skills add dart-lang/skills --skill '*' --agent universal

运行这些命令会自动创建 .agents/skills 目录，并将请求的 skills 下载到项目中。

有关可用 skills、更新与贡献的更多详情，请参阅 Dart skills 仓库 与 Flutter skills 仓库。