Flutter UI实现标准：资源管理、编码规范与组件化开发最佳实践
The Agent Skills Directory
安装命令
npx skills add https://smithery.ai/skills/tuanvo3423/flutter-ui-implementation-standard🇨🇳中文介绍
Flutter UI 与资源实现标准
本技能定义了实现 UI 和处理资源的严格规则，以确保一致性并防止错误。
1. 资源管理（关键）
目标：防止出现"随机字符串"文件名并确保设计保真度。
- 规则 1.1：导入时重命名：绝不保留 Figma 导出的原始文件名（例如
mkl6t7hq...svg）。- 操作：在使用资源之前，必须将其重命名为语义化的
snake_case名称。 - 前缀：
- 图标：
icon_<名称>.svg（例如icon_user.svg、icon_back.svg） - 导航：
nav_<名称>.svg（例如nav_home.svg） - 图片：
img_<名称>.png - 背景：
bg_<名称>.png
- 图标：
- 操作：在使用资源之前，必须将其重命名为语义化的
- 规则 1.2：设计保真度：始终使用设计中提供的 SVG/PNG 资源。
- 禁止：不得用 Flutter 内置的
Icons.*替代设计资源，除非明确要求或该资源缺失。
- 禁止：不得用 Flutter 内置的
- 规则 1.3：SvgPicture：对所有矢量图标使用
flutter_svg包和SvgPicture.asset()。
2. 编码标准
目标：防止常见的 lint 错误（如 const_with_non_const）并确保代码整洁。
- 规则 2.1：常量正确性：
BorderRadius.circular(N)不是常量。- 正确（常量）：
BorderRadius.all(Radius.circular(N)) - 正确（非常量）：如果使用
BorderRadius.circular，则移除const关键字。
- 规则 2.2：主题化：
- 首先在
AppTheme/AppColors中定义所有颜色和渐变。 - 对渐变文本使用
ShaderMask。 - 对渐变背景使用带有
BoxDecoration的 。
- 首先在
3. 实现流程
- 分析：查看设计截图和原始资源文件。
- 准备资源：重命名所有必需的资源并将其移动到
assets/images/。 - 准备主题：使用必要的颜色和样式更新
AppTheme。 - 实现：使用重命名后的资源和主题构建 Widget。
4. 页面组件（关键）
目标：通过将页面特定的 UI 块拆分到 components/ 中，保持每个屏幕的可维护性。
- 页面组件路径（本仓库）：
lib/src/features/<功能>/presentation/components/ - 页面组件：仅由该页面使用的布局块和 UI 片段
- 规则：页面文件是组合根；将块委托给
components/中的 widget
每周安装次数
–
来源
首次出现
–
🇺🇸English
Flutter UI & Asset Implementation Standard
This skill defines the STRICT rules for implementing UI and handling assets to ensure consistency and prevent errors.
1. Asset Management (CRITICAL)
Goal : Prevent "random string" filenames and ensure design fidelity.
- Rule 1.1: Rename on Ingestion : NEVER leave assets with raw Figma export names (e.g.,
mkl6t7hq...svg).- Action : You MUST rename assets to semantic
snake_casenames before using them. - Prefixes :
- Icons:
icon_<name>.svg(e.g.,icon_user.svg,icon_back.svg) - Navigation:
nav_<name>.svg(e.g., )
- Icons:
- Action : You MUST rename assets to semantic
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
