---
name: fkit-feature
description: 创建、修改和重构 FlutterKit 业务模块与页面，覆盖基础父类选择、View、Logic、State、Binding、按需目录、国际化、路由接入和预览。用户要求新增 Feature、页面、模块目录、页面模板或调整页面分层时使用。
---

# FKit Feature

## 必读资料

先阅读仓库根目录 `AGENTS.md`，再按任务读取：

- `docs/flutter-kit/业务功能/index.md`
- `docs/flutter-kit/业务功能/structure.md`
- `docs/flutter-kit/业务功能/create-page.md`
- `docs/flutter-kit/业务功能/templates.md`
- 当前层对应的 `view.md`、`logic.md`、`state.md`、`binding.md`
- `docs/flutter-kit/框架核心/base.md` 及所选父类专题

涉及 UI、导航、数据或预览时继续遵守对应 FKit Skill 与项目文档。

## 工作流

1. 检查目标 Feature、相邻页面、路由和测试，确认现有命名与依赖方式。
2. 根据数据形态选择普通、网络、分页、刷新或 Tab 父类，禁止在普通页面复制父类状态机。
3. 按真实复杂度创建 View、Logic、State、Binding；不要为了目录完整创建空文件。
4. 将单页模型、静态数据、小型 Widget、Skeleton 和行为留在页面附近。同一模块多页面复用时才提升到模块级按需目录，跨 Feature 复用时才进入 Core。
5. 让 View 只布局、订阅和转发事件；让 Logic 处理生命周期、Repository/Service、状态与导航；让 State 只保存展示状态；让 Binding 只注册依赖。
6. 将用户可见文案写入模块 `localization/`，并接入路由、Navigator 和 Preview。
7. 补充对应测试，检查 Feature 未直接依赖其他 Feature 的内部实现。

## 关键约束

- Feature `data/` 只保存模块共享静态配置、展示数据或提供器，不创建第二套 Repository/DataSource。
- Repository 字段使用完整领域名称，例如 `_userInfoStoreRepository`，不用 `_repository`。
- 模块 Service 只服务本模块多个路由；应用级跨模块状态才进入 `core/service/`。
- 单页私有 Widget 优先作为 View 私有方法或相邻文件，不提前提升到模块 `widgets/`。
- 修改现有页面时保留公开行为和路由契约，除非任务明确要求变更。

## 验证

格式化本次涉及的 Dart 文件，运行最小相关测试、必要的 Preview 测试、`flutter analyze` 相关范围和 `git diff --check`。确认没有手工修改生成文件。