如何在智能体驱动的Flutter开发中使用技能：开发者手册
内容提要
本文介绍Flutter开发中AI代理技能（Agent Skills）的使用方法。AI代理常因不了解团队规范而生成不合规代码，技能通过Markdown文件教授代理特定任务的最佳实践，如文件组织、状态管理等。官方Flutter和Dart技能库可安装，团队也可自写技能编码经验。技能采用渐进式加载，兼容多种AI工具，能显著提升代码质量与一致性。
延伸解读
技能的核心价值：编码经验的可移植化
文章指出，AI代理生成的代码不合规，并非因为技术差，而是不了解团队的具体约定。技能（Skills）通过Markdown文件将团队规范、架构模式等经验编码，使代理在生成代码时遵循这些规则。这相当于把资深工程师的隐性知识显性化，让AI也能按团队标准工作，从而提升代码一致性与质量。
渐进式加载：平衡上下文与效率
技能采用渐进式披露机制，代理先读取轻量级元数据（如描述），仅在任务匹配时才加载完整内容。这避免了将所有技能塞入上下文窗口，节省了宝贵的上下文空间，使得项目可以拥有大量技能而不会影响性能。理解这一机制有助于编写更有效的技能描述，确保相关技能能被正确触发。
官方技能与自定义技能：互补策略
Flutter和Dart团队提供了官方技能库，覆盖响应式布局、路由、序列化等常见场景，可作为起点。但文章强调，团队自写的技能价值更高，因为它们针对特定项目的具体错误和模式。建议先安装官方技能，再根据团队经验编写自定义技能，两者结合能更全面地提升AI生成代码的适配性。
跨工具兼容：一次编写，处处运行
技能遵循通用标准（agentskills.io），可在Claude Code、Cursor、Codex等主流AI编码工具间无缝使用。这意味着团队只需编写一次技能，所有成员使用的不同工具都能受益，无需为每个工具单独维护。这种标准化降低了采用成本，也便于在团队内共享和积累知识。
Q&A
什么是智能体技能（Agent Skills）？
智能体技能是结构化的Markdown文件，用于向AI编码代理传授特定任务的最佳实践，包括团队规范、架构模式、文件组织规则等。它们遵循agentskills.io的通用标准，存放在项目的.agents/skills/目录下，支持渐进式加载，兼容多种AI工具。
为什么AI代理在Flutter开发中会生成不合规的代码？
因为AI代理的训练数据包含大量风格混杂的代码，它不了解特定团队的规范。常见的错误包括：使用私有构建方法而非提取组件、将StatefulWidget与State分离、忽略团队的状态管理选择、使用Map而非类型化模型、硬编码视觉值、添加不必要的注释、错误的导入路径以及原始异常处理。
如何安装官方的Flutter和Dart技能？
使用npm命令安装：`npx skills add flutter/agent-plugins --skill '*' --agent universal --yes` 安装Flutter技能，`npx skills add dart-lang/skills --skill '*' --agent universal --yes` 安装Dart技能。也可以同时安装两个仓库。安装后技能会放在.agents/skills/目录下。
技能文件的结构是怎样的？
技能文件包含YAML frontmatter和Markdown正文。frontmatter包括name（唯一标识）、description（最关键，用于触发匹配）、aliases（别名）和sources（来源）。正文以#标题开头，包含简介、##核心规则、##子模式、##代码示例等部分，提供具体可操作的规则和正反例。
技能与规则文件（如CLAUDE.md）有什么区别？
技能是任务导向的，按需加载，提供特定任务的详细指导；规则文件是项目级的事实，始终在上下文中。技能通过渐进式披露只在相关任务时加载，而规则文件每次都会加载。技能适合编码规范，规则文件适合项目基本信息。
如何编写自己的技能？
编写技能需要创建Markdown文件，包含YAML frontmatter（name、description等）和正文。正文应包含简介、核心规则、子模式和代码示例，规则要具体可验证，并展示错误和正确模式。技能应编码团队的具体经验和模式，存放在.agents/skills/目录下。
技能如何在不同AI代理中使用？
技能遵循通用标准，兼容Claude Code、Antigravity、OpenAI Codex、Cursor等。安装时使用--agent参数指定代理，或使用--agent universal放在通用目录。各代理会自动发现技能，无需手动调用。
技能如何工作？什么是渐进式披露？
技能采用渐进式披露机制：代理先索引所有技能的元数据（description），当任务匹配时只加载相关技能的完整内容，避免上下文窗口浪费。这样即使有多个技能，也不会增加上下文负担。
