메뉴
将 FlutterKit 脚手架初始化为新的应用项目，统一修改应用显示名称、Dart 包名、Android Application ID、Apple Bundle ID、Linux/Windows 标识、Web 名称、运行时品牌文案、Logo、桌面图标和启动页。用户拉取模板后要求改名、改包名、替换品牌资源或完成首次项目配置时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
审查 FlutterKit 项目或指定模块的架构边界、命名、注释、TDesign 与设计系统使用、预览、测试、生成文件和多端配置。用户要求全盘扫描、代码审查、架构检查、注释检查、预览完整性检查或质量报告时使用。
实现和维护 FlutterKit 数据访问链路，覆盖实体、请求、响应、Repository、网络、数据库、本地存储、RequestHelper、分页与全局 Service。用户要求接入接口、持久化数据、创建模型、处理请求结果或实现网络列表时使用。
创建、修改和重构 FlutterKit 业务模块与页面，覆盖基础父类选择、View、Logic、State、Binding、按需目录、国际化、路由接入和预览。用户要求新增 Feature、页面、模块目录、页面模板或调整页面分层时使用。
管理 FlutterKit 多端运行时资源、应用图标、原生启动页、Android/iOS/Web/桌面端配置和发布构建。用户要求生成图标、启动页、FlutterGen 资源、同步原生底座、排查原生缓存或执行多端打包时使用。
配置和维护 FlutterKit 模块化导航，覆盖 Routes、Pages、Navigator、Binding、Params、Result、Guard 与跨模块跳转。用户要求新增路由、页面跳转、传参、结果回传、登录拦截或修复导航状态时使用。
为 FlutterKit 页面和组件新增、修复或审查 Widget Preview，覆盖响应式设备注解、Logic 注入、静态 Preview Data、网络状态和深浅色检查。用户提到预览、Widget Preview、页面预览、组件预览或全量补预览时使用。
| name | fkit-setup |
| description | 将 FlutterKit 脚手架初始化为新的应用项目，统一修改应用显示名称、Dart 包名、Android Application ID、Apple Bundle ID、Linux/Windows 标识、Web 名称、运行时品牌文案、Logo、桌面图标和启动页。用户拉取模板后要求改名、改包名、替换品牌资源或完成首次项目配置时使用。 |
先阅读仓库根目录 AGENTS.md、docs/flutter-kit/扩展/assets.md、README.md 的构建章节，以及 .agents/skills/fkit-native/SKILL.md。修改配置前检查当前六端原生文件、pubspec.yaml、图标与启动页 YAML，不凭记忆猜测 Flutter 模板字段。
在写入前取得以下信息；缺失的关键标识必须向用户确认，不自行创造：
| 信息 | 格式与用途 |
|---|---|
| 应用显示名称 | 用户可见名称，可包含空格和中文 |
| Dart 包名 | snake_case，用于 pubspec.yaml 与 package: import |
| Application/Bundle ID | 小写反向域名，例如 com.example.product |
| 项目描述 | pubspec.yaml、商店或 README 简介 |
| 公司与版权 | Windows、macOS 等原生元数据 |
| 仓库、文档、Demo 地址 | 关于页与 README；缺失时保留或删除，禁止假地址 |
| Logo、图标、启动页源图 | 运行时 Logo、通用图标、iOS 安全边距图、Android 12 启动图 |
| 目标平台 | Android、iOS、macOS、Linux、Windows、Web 的实际支持范围 |
先建立旧值到新值的明确映射，区分显示名称、Dart 包名、原生 ID、二进制名和品牌资源，不做单一字符串的全仓库替换。
应用改名不等于抹除框架来源。默认保留以下内容中的 FlutterKit/FKit 名称：
docs/flutter-kit/ 与 docs/tdesign-flutter/ 框架参考文档。.agents/skills/ 目录中的 fkit-* 项目 Skill 名称和触发描述。AGENTS.md 中的框架技术规范。只修改运行时身份、应用专属说明和用户明确要求重写的仓库资料。完成后按允许列表审查旧标识残留，不把框架文档中的合法名称当作错误。
| 范围 | 重点位置与操作 |
|---|---|
| Flutter/Dart | 修改 pubspec.yaml 的 name、description；Dart 包名变化时更新 lib/、test/ 中全部 package: import |
| 运行时文案 | 修改应用名称国际化、关于页名称、项目链接和业务品牌文案，不改框架文档术语 |
| Android | 修改 namespace、applicationId、Manifest label；同步移动 MainActivity 包目录并修改 Kotlin package 声明 |
| iOS | 修改 Runner 与 RunnerTests 的 PRODUCT_BUNDLE_IDENTIFIER，同步 CFBundleDisplayName、CFBundleName |
| macOS | 修改 PRODUCT_NAME、Bundle ID、RunnerTests ID、版权、.app 引用、Scheme 与测试宿主路径 |
| Linux | 修改 BINARY_NAME、APPLICATION_ID 和窗口标题 |
| Windows | 修改 CMake project/binary、窗口标题、Runner.rc 的公司、描述、内部名、文件名、产品名和版权 |
| Web | 修改 manifest name、short_name，以及 index 的页面标题和 Apple Web App 名称 |
| 品牌资源 | 更新 assets/image/logo.png 与 assets/dev/ 生成源图，核对两个 YAML 后运行图标和启动页生成器 |
| 项目资料 | 按用户决定更新 README、关于页、仓库、文档和 Demo 地址，禁止保留 example.com 等占位链接 |
fkit-native 流程检查尺寸、Alpha、透明边距和 Android 12 安全区。flutter pub get。dart run build_runner build --delete-conflicting-outputs。dart run flutter_launcher_icons 与 dart run flutter_native_splash:create。dart format、flutter analyze、flutter test 和 git diff --check。--no-codesign、macOS 与 Web；Linux、Windows 在对应系统验证。