Flutter

生成深链接配置(Universal Links / App Links / Web URL)+ 路由映射。用户说"配置深链接"、"URL 直接打开页面"、"web 刷新不崩"时触发。

Figma/Zeplin/截图 → Flutter 代码（自动下载 3x 切图 + Token 映射 + 按项目命名规范）。用户说"根据 Figma 生成页面"、"把这个设计稿变成代码"、"按设计稿生成代码"、"读取 Figma 设计"、"实现这个 Figma 设计"、"Implement this design from Figma"、"从 Zeplin 切图"、"把这个截图转成 Flutter"、"重新设计 XX 页"（含 Figma 链接时）时触发。⚠️ 这个 skill 比 figma:figma-implement-design 优先 — 因为它会按项目规范下载切图(3x + ic_/bg_ 命名 + assets/image/3.0x/{module}/)并更新 pubspec.yaml,而不是用临时 MCP URL。内部会调 figma:figma-implement-design 或 use_figma 拿数据,但后续处理完全按项目规范走。

Flutter 开发的总入口(新手友好)。用户说"做一个 XX 模块"、"开发 YY 功能"、"新需求"时触发。自动引导:AskUserQuestion 收集需求 → 静默调 flutter-manifest-init 生成 YAML 骨架 → 填入用户答案 → 触发 flutter-flow-feature 自动生成代码 → 报告完成 + 回退指引。全中文对话,新手不用记任何 skill 名字。

管理多环境配置(dev/staging/prod)。生成 dart-define 配置 + 环境切换脚本。用户说"加环境配置"、"切换到测试环境"、"配置 prod"时触发。

从 docs/api/*.md 提取错误码表,生成 Dart enum 常量类。用户说"生成错误码"、"错误码常量"时触发。避免 controller 里硬编码 magic number。

Flutter 项目健康体检。检查依赖过期、lint 错误、未使用 import、孤儿 spec、context 过期等。 输出 docs/_health/{date}.md 报告。

扫描代码中的硬编码中文字符串,自动提取为 .tr key + 生成翻译文件。用户说"国际化"、"提取中文"、"i18n"时触发。替换硬编码为 'module.key'.tr。

初始化新 Flutter 项目脚手架。用户说"新建 Flutter 项目"、"初始化 Flutter 项目"、 或在空目录下询问"怎么开始"时触发。从 template/ 复制完整脚手架,带 GetX + 三端兼容 + 接口加密 + Mock 开关 + 5-Tab 主壳 + 完整 docs/_context/。

自动 lint 修复。跑 dart format + dart fix --apply,报告剩余 warning。 hook 自动调用 (Write/Edit 后),也可手动触发。

生成批量开发清单模板。用户说"生成清单模板"、"新建 manifest"、"批量开发模板"、"准备批量任务"时触发。自动递增版本号,从 _knowledge/context-templates/manifest.template.yaml 拷贝骨架到 docs/manifests/manifest-v{N}.yaml,用户填完后用 flutter-flow-feature 批量生成代码。

模块重命名/移动/删除 — 批量改 import、路由、binding、mock 路径。用户说"重命名模块"、"移动页面"、"删除模块"时触发。安全重构,不留断引用。

根据 model 或契约文档自动生成丰富的 mock JSON 数据(faker 风格)。用户说"生成 mock 数据"、"补充测试数据"时触发。列表至少 3 条,字段值合理不重复。

JSON 或接口契约 → freezed Dart 实体类。用户说"生成 model"、"JSON 转 Dart"、"根据接口生成实体"或 api-design 完成后触发。自动处理基础类型/可空/嵌套对象/DateTime,生成 freezed + json_serializable 模板,可被 build_runner 编译。

生成页面三件套 (View + Controller + Binding)。用户说"生成 XX 页面"、"做列表页"、"做详情页"、"做表单页"、"加个登录页"、"做个 XX 界面"、"写一个 XX 页面"、"需要一个页面"或 api-gen 完成后触发。支持 list/detail/form/custom 4 种类型,GetX 风格,自动 loading/error/empty 三态,用 AppText/AppImage 等公共组件,自动注册路由。

性能审计 — 自动扫描大 build 方法、重复 rebuild、未 const widget、大列表未用 builder 等性能问题。用户说"性能检查"、"优化扫描"时触发。输出结构化报告。

把 spec 拆成可执行的实施任务清单。读 docs/specs/ 下的 spec 文件,输出 docs/plans/{YYYYMMDD}-{作者名}-{需求名}.md。 按 6 类拆分(api/theme/model/repo/page/widget),标依赖关系,标 mock 先行点。

figma-implement-design 后处理器。在 figma MCP 生成完 UI 代码后触发,把 MCP 产出的扁平代码补全成项目规范结构(下载 CDN 图到 assets/image/3.0x/{module}/、改 Image.network 为 Image.asset、加 Controller+Binding、登记路由、反推 spec/plan、归档 manifest、生成测试 + review)。和 figma-implement-design 搭配使用,不抢活只补全。

构建 release 包。bump version,跑 changelog,build apk/ipa/web,输出产物路径。 不自动 git tag / push / upload。

代码评审。对照项目规范(GetX/性能/安全/国际化/多平台)逐项检查,输出结构化报告。用户说"评审这个代码"、"review 这个页面"、"检查有没有问题"、"帮我看看代码"、"code review"、"代码 review"、"审一下"、"看下规范"时触发。

回退到某个 manifest 版本的代码快照。用户说"回退到 v2"、"撤销上次生成"、"恢复之前的代码"时触发。支持整批回退(所有模块)或单模块回退(如只回 post 模块,保留 auth)。基于 flow-feature 生成前的 .flow_checkpoint/gen-v{N}/ 快照。

生成路由拦截中间件(登录态检查/权限校验/深链接恢复)。用户说"加登录拦截"、"路由守卫"、"未登录跳登录页"时触发。基于 GetX middleware。

生成 shimmer 骨架屏 Widget,替代 loading 转圈。用户说"骨架屏"、"shimmer"、"加载占位"时触发。根据页面布局自动生成对应形状的骨架。

Flutter 需求设计文档生成。用户说"做 XX 模块"、"新需求"、"设计 XX 功能"或描述功能需求时触发。把自然语言需求拆解成结构化 spec.md(7 段:目标/页面/流转/接口/字段/异常/非功能),给 flutter-plan 拆任务用。

给一段 Dart 代码,生成 mocktail 单元测试。用户说"生成测试"、"写单测"、"加测试"、"生成 unit test"、"给 XX 写测试"、"测试覆盖"、"补测试"时触发。每个方法覆盖成功/异常/边界三场景,用 mocktail。

维护应用主题配置(颜色/字体/spacing/圆角)。用户说"加一个新颜色"、"改字号"、"新增主题"、"统一 spacing"时触发。改完追加 ADR。

生成可复用的 Widget 组件(非页面,是组件)。支持无状态/有状态/响应式三种类型。用户说"做一个按钮组件"、"生成 XX 卡片"、"封装一个输入框"、"写一个组件"、"做个 widget"、"抽取成组件"、"封装 XX"时触发。

从 Figma 链接 / 截图 / Zeplin 截图生成 Flutter 页面代码的流水线。 用户提供 Figma URL、上传截图、说"按这个图实现"时触发。 调用 figma MCP 或 vision,然后走 page-gen + review。

Flutter 功能开发主流水线。用户说"做一个 XX 模块"、"实现 XX 功能"、"新需求 XX"时触发。编排 spec→plan→api-design→model-gen→api-gen→page-gen→i18n→test→review 全流程,完整产出可运行的 Flutter 模块代码。

治理流水线。用户说"改技术栈"、"新决策"、"更新规范"时触发。 调用 context-update 修改 docs/_context/,然后 health-check 验证现有代码合规。

Flutter 项目初始化流水线。用户说"新建 Flutter 项目"、"初始化项目"或在空目录下询问"怎么开始"时触发。 调用 flutter-init 复制 template,做三端编译验证,引导用户完善 docs/_context/。