Flutter 发布官方 Skills ，Flutter 在 AI 领域再添一助力

zhenglin

2026年3月6日 17:11 本文热度 138

在之前的《Flutter 2026 Roadmap》我们就聊到，如今一个项目要有发展前景，就必须能够和 AI 持续贴一起，而显然 Flutter 做到了，除了之前的 Flutter MCP ，GenUI 等 AI 相关支持产物，现在官方又新增了 flutter/skills 支持，用于补全 Flutter 在 AI 编程缺乏官方 skills 的短板。

flutter/skills 作为给 AI Agent（Agent / Copilot / Claude / Cursor 等）用的技能库，核心目标是让 AI 在 Flutter 项目里，面对执行复杂开发流程时，AI 有相应的规范和指导流程 ：

决策逻辑：告诉 AI 什么时候该选哪种方案
详细指令：包含具体的代码实现和步骤
严格约束：防止 AI 生成错误或过时的代码（如禁止使用已废弃的 API）

当然，这些 skills 所需的数据，其实都来自项目里的 Skills CLI ，Skills CLI 会调用 Gemini，把官方的 Flutter 文档“压缩成可执行的 SKILL.md” ，也就是它会 crawl 文档网站找页面，然后用 Gemini 转成结构化 SKILL.md，对此 CLI 的主要有两个核心命令：

generate-skill：从 YAML 生成（支持 --skill 只生成某一个；支持 --directory 输出到指定目录）
validate-skill：重新生成并和已有 skills 比对，用来做一致性/回归验证（还支持 --thinking-budget）

具体流程为：

通过 resources/flutter_skills.yaml 指定技能名称、描述以及原始文档的资源链接（HTTPS 或本地文件）
ResourceFetcherService 抓取网页内容，并由 MarkdownConverter 将 HTML 转换为干净的 Markdown 格式，去除导航栏、页脚等噪点
调用 Gemini 接口，向 AI 发送原始文档、技能模版指令（skill_instructions.dart）和特定提示词（Prompts.dart），要求 AI 生成符合规范的技能文档
生成的 SKILL.md 包含统一的 H1 标题、## Goal（目标）、## Instructions（指令）和 ## Constraints（约束）和代码片段
提供 validate-skill 命令，让 AI 重新审视已生成的技能，根据准确性、结构和完整性进行打分（0-100分），确保输出质量

而在目前的项目，主要覆盖有 20 多个不同技能：

这些技能在 AI Coding 的时候，可以很好帮助 AI 完成项目管理和迭代，比如 flutter-plugins 里：

会明确包含哪些修改 build.gradle 或 Info.plist 的具体步骤
是使用 ffi 还是 Method Channels
是不是需要使用 Package-Separated Federated Plugin

这对于 AI 在决策和实现 Flutter Plugin 代码生成的规范和成功率都有明显提升，同样的，对于 flutter-architecture ，可以让 AI 在写代码是遵循「Clean Architecture」，让 AI 输出单向数据流 + 严格分层（UI/Domain/Data）+ 职责隔离的架构，例如：

分层约束：UI / Data /Domain 的职责边界
数据源拆分：Remote Service vs Local Service 的建模方式
Service 纯封装：Service 必须无状态、无业务逻辑
Repository 单一可信源：只有 Repository 能 mutate 数据
错误显式化：Repository 捕获异常并返回 Result Ok/Error
可观察数据流：Repository 可通过 Stream 对外暴露变化
状态管理：ChangeNotifier 持有 UI state、集中处理交互
Command 模式：用 Command0 封装异步动作/交互入口，避免 View 直接写 async 逻辑
View 零业务逻辑：View 只能布局/简单条件渲染/路由，不做数据变更
单向数据流校验规则：Repository → ViewModel → View（数据下行），View → ViewModel → Repository（事件上行），并提供“Validate and Fix”的修复策略