免费在 GitHub 公开

feature-screen

Create a new Flutter screen in this repository using the existing feature structure, AutoRoute setup, Riverpod state pattern, and code generation workflow. Use when adding a new page, route, stateful screen, or feature folder in this template.

中文简介正在准备中。当前显示原文说明。

strvcom/flutter-template

查看安装方法

包含的文件（1）

SKILL.md3.1 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Flutter Template Feature Screen

Use this skill when adding a new screen or route to this repository.

Read First

AGENTS.md
docs/PROJECT_OVERVIEW.md
docs/PROJECT_GUIDELINES.md
lib/app/navigation/app_router.dart

Default Output

Create work inside lib/features/<feature>/.

Prefer this shape when the screen owns state:

lib/features/<feature>/
  <feature>_page.dart
  <feature>_page_content.dart
  <feature>_state.dart
  <feature>_event.dart

For simple static screens, *_state.dart and *_event.dart may be unnecessary.

Workflow

Inspect nearby features with a similar level of complexity.
Create the new feature folder under lib/features/.
Add the route widget with @RoutePage().
Put larger widget trees into *_page_content.dart.
If the screen has async state, create a freezed state plus @riverpod notifier in *_state.dart.
If the screen needs one-off navigation, snackbar, or dialog effects, create a freezed event union in *_event.dart and listen in the page widget.
Register the route in lib/app/navigation/app_router.dart.
Use shared widgets and extensions before adding new abstractions.
If data is needed, add DTOs, entities, and use cases in the shared locations instead of doing IO in widgets.
Check narrow and wide layout behavior for the page content. Use LayoutBuilder for parent constraint-driven layouts, wrap flexible Row content in Expanded/Flexible, and avoid fixed dimensions that can overflow localized text.
Run make gen, then fvm flutter analyze, then relevant tests.

Conventions To Keep

Keep *_page.dart thin.
Prefer CustomAppBar, shared components, and shared compositions.
Use context.colorScheme, context.textTheme, and context.locale.
Use DTOs in lib/common/data/dto/ and entities in lib/common/data/entity/.
Put IO-oriented behavior in lib/common/usecase/.
Use AsyncValueExtension.mapState or mapContentState for async UI.
Do not hand-edit generated files.

Checklist

Route added and generated route class available
Feature files follow the existing naming pattern
No direct service wiring inside widgets unless the existing code already does it
make gen completed
Analyze completed
Tests updated when behavior changed

Watch Outs

This template mixes fully-wired code with scaffolded placeholders. Check lib/app/setup/setup_app.dart before assuming a service is active.
Do not invent a CustomScaffold; current template screens use Scaffold directly.
Localization currently starts from assets/localization/app_en.arb. Add keys there and regenerate.
If a screen overflows or needs meaningful responsive behavior, use the layout-debug skill before final verification.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

build-verify

免费

Build/test/lint verification pass for this Flutter app — runs codegen, analyze, test, then iOS + Android native builds in parallel, then `dart format`. Does NOT commit anything; leaves the working tree dirty so the user can review and commit on demand. Used at the end of the prd → techspec → tasks → implement-tasks-sequence flow before `pr-review`, and can also be invoked manually when the user says "verify build", "run full verification", or "check everything".

中文简介正在准备中。当前显示原文说明。