본문으로 건너뛰기
cccskills
무료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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

  1. Inspect nearby features with a similar level of complexity.
  2. Create the new feature folder under lib/features/.
  3. Add the route widget with @RoutePage().
  4. Put larger widget trees into *_page_content.dart.
  5. If the screen has async state, create a freezed state plus @riverpod notifier in *_state.dart.
  6. 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.
  7. Register the route in lib/app/navigation/app_router.dart.
  8. Use shared widgets and extensions before adding new abstractions.
  9. If data is needed, add DTOs, entities, and use cases in the shared locations instead of doing IO in widgets.
  10. 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.
  11. 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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

create-pr

무료

Create or update a GitHub PR for this Flutter repository using gh CLI. Verifies the work with build-verify and pr-review, generates an inline PR description, commits pending changes when approved, pushes, and opens or updates the PR. Supports stacked PRs by asking for the base branch when detection is ambiguous. Use when the user says "create PR", "open PR", "push PR", or wants to submit their work for review.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

feature-data-flow

무료

Build a full feature in this Flutter repository that includes backend or storage data flow: read API schema, create DTOs, map DTOs to entities, add Riverpod use cases, connect feature state, and render UI data. Use when a task goes beyond a screen and needs real data integration.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

implement

무료

Implement a single Flutter task following this repository's Riverpod, Freezed, AutoRoute, DTO/entity, codegen, and verification conventions. Reads the task definition, PRD, and tech spec, then executes the implementation. When invoked standalone, verifies the change; when invoked by implement-tasks-sequence, writes code only and leaves verification to start-job/build-verify. Use when the user says "implement task X", "work on task X", or wants to execute a specific task from the task list.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

implement-tasks-sequence

무료

Orchestrates implementation of all tasks for a feature using an agent team. Respects task dependencies, runs tasks in correct order, parallelizes independent tasks. Does NOT build, run tests, or commit at any point — verification is delegated to the caller (typically `/start-job`, which runs `build-verify` and `pr-review uncommitted` afterwards). Use when the user says "implement all tasks", "run the task sequence", "implement the feature", or wants to execute multiple tasks from a task list end-to-end.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

layout-debug

무료

Diagnose and fix Flutter layout, overflow, unbounded constraint, scroll, and responsive rendering issues in this repository while preserving the template's existing feature, theme, localization, and shared widget patterns. Use when UI overflows, text clips, widgets disappear, layouts fail on mobile/tablet/desktop, or a feature needs responsive behavior.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

strvcom의 스킬 모두 보기

이 스킬의 문제 신고