1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | flutter-best-practices-evanca-flutter-ai-rules |
| 作者/维护者 | Ivanna（GitHub：evanca） |
| 来源链接 | github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-best-practices |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars / Forks | 604 / 60（数据来自 GitHub API；数字属整个 flutter-ai-rules 合集仓库，不代表本技能自身热度） |
| 最新版本 | 无正式版本标签，仓库持续滚动更新（数据来自 GitHub API） |
| 安装方式 | 手动复制 skills/flutter-best-practices/ 目录到 IDE 的 skills 目录；或用第三方 Skills CLI 一键安装 |
2. 功能介绍与亮点
flutter-best-practices 是一份面向 Flutter/Dart 开发的架构与编码规范技能，内容全部萃取自 Flutter/Dart 官方文档（Flutter App Architecture、Effective Dart 等）以及 Flutter 咨询公司 LeanCode 在 40 余个生产项目（含一个 30 人团队的银行类 App）中沉淀的工程经验。
核心内容按主题拆成 5 篇参考文档，供 Agent 按任务类型精准调用：
- 架构分层（
architecture-layers.md）：UI 层与数据层如何拆分，View → ViewModel → Repository → Service 的单向依赖规则 - 功能模块结构（
feature-structure.md）：新建 feature 时的目录组织与状态管理接线方式 - Dart/Flutter 编码规范（
dart-coding-practices.md）：widget、测试、lint 相关的写法与审查要点 - 企业级规模（
enterprise-scale.md）：多团队 / monorepo / 导航 / 本地化 / API 契约 / 端到端测试 - 本地化包边界（
localization-package-boundaries.md）：多语言字符串归属与语言切换器可见性规则
亮点：内容不含个人主观偏好，每条规则都可追溯到官方文档或知名咨询公司的公开方法论；仓库创建于 2025 年 4 月，运行超过一年仍保持高频更新（近期一次提交为触及本技能内容的更新）。
3. 适用场景
所属固定分类：前端与设计（该技能围绕 Flutter 这一前端 UI 框架的项目结构、状态管理与 widget 编码规范展开）。
适用于：
- 用 Flutter 从零搭建新项目或新 feature，需要一套开箱即用的目录结构与分层规则
- 团队协作时统一代码风格，减少 Code Review 中反复纠正架构问题的成本
- 在 AI 编程助手（Claude Code、Cursor、Codex 等）中让 Agent 生成的 Flutter 代码天然符合官方推荐架构，而不是每次都要人工纠偏
- Flutter 初学者缺乏架构直觉时，作为“如何组织一个 Flutter 项目”的参考手册
4. 跨 Agent 兼容性
- Claude Code：原生支持。技能采用标准 SKILL.md 格式，可直接放入
~/.claude/skills/使用；仓库 README 明确将 Claude Code 列为支持的 IDE 之一 - Codex：原生支持。README 引用
AGENTS.md／OpenAI Skills 官方文档，将 Codex 列为支持对象 - OpenClaw：未验证。仓库材料未提及 OpenClaw
- Hermes Agent：未验证。仓库材料未提及 Hermes Agent
5. 推荐理由
这是一份内容来源可核查、维护持续超过一年的 Flutter 架构规范技能——每条规则都能追溯到 Flutter/Dart 官方文档或 LeanCode 的公开工程实践，避免了“AI 编的最佳实践”这一常见风险。对于用 AI 辅助写 Flutter 的开发者，装上它能让 Agent 生成的代码从一开始就符合官方推荐架构，减少后期返工与 Code Review 摩擦。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 所属 flutter-ai-rules 合集仓库 604 Stars / 60 Forks，该数字属整个合集仓库，不代表本技能自身热度；本子技能自身除仓库层面的持续维护与作者公开分享外，暂无可核实的独立第三方评价数据 |
| 可用性 | 9 | 复制目录即可使用，也支持第三方 CLI 一键安装；SKILL.md 主文档 + 5 篇结构化参考文档合计约 34KB，每条规则均附官方文档出处；近期仍在更新；无付费依赖 |
| 安全性 | 9 | 纯 Markdown 规则/文档类技能，无代码执行、无网络外发、无需任何凭据；MIT 协议清晰；维护活跃 |
安全检查清单： ① 是否执行 shell 命令：否，纯文档指导 Agent 编写代码，不含可执行脚本 ② 运行时是否联网外发数据：否 ③ 是否要求 API key/凭据：否 ④ SKILL.md 及内容有无可疑指令：未发现提示词注入或异常指令 ⑤ 作者信誉：个人开发者公开维护超一年，规则内容均可追溯官方来源，无造假迹象 ⑥ License：MIT，明确 ⑦ 最近维护时间：近期仍有提交，维护活跃
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| flutter-best-practices（本技能） | Flutter 全局架构与编码规范，来源全部为官方文档 + LeanCode 生产经验 | 覆盖架构分层、目录结构、企业级规模等宏观维度 |
| riverpod / bloc / provider（同一合集内的其他子技能） | 各自聚焦单一状态管理库的用法规范 | 范围更窄，只解决“用哪个状态管理库”这一层问题，不涉及整体项目架构 |
| react-best-practices | React 项目的架构与编码规范技能 | 服务对象是 React 生态而非 Flutter/Dart，技术栈完全不同 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
flutter-ai-rules 仓库同时提供“预组合规则包”（combined/ 目录），把 Flutter + 常用状态管理库的规则合并成单个文件，控制在 6000 字符以内以适配部分 IDE 的全局规则长度限制，供不使用 Skill 格式的 IDE 参考。
10. 安装使用方式
方式一（推荐）：手动复制
git clone https://github.com/evanca/flutter-ai-rules.git
cp -r flutter-ai-rules/skills/flutter-best-practices ~/.claude/skills/复制后 Agent 会根据任务自动判断何时读取该技能，无需手动触发。
方式二：第三方 Skills CLI
npx skills add evanca/flutter-ai-rules --skill flutter-best-practices⚠️ 该 CLI（vercel-labs/skills）存在两个尚未修复的公开 issue（#1817、#699），指控其在未明确告知的情况下上传使用数据，且不完全受 DISABLE_TELEMETRY 环境变量约束。截至 2026-08-05，两个 issue 均仍处于 open 状态。若在意此风险，建议优先使用方式一的手动复制路径。
11. 注意事项
- 本技能所属仓库为多技能合集（35 个子技能），本报告仅评估 flutter-best-practices 这一个子目录；同合集内 riverpod、bloc、firebase 系列等其他子技能未在本次评估范围内
- 规则内容基于 Flutter 官方文档在评估时的版本，Flutter/Dart 后续版本更新可能导致部分规则过时，建议定期核对
references/中引用的官方文档链接 - 若通过第三方 Skills CLI 安装，请知悉上述第 10 章披露的遥测投诉