AgentSkillsCN

riverpod-state

使用Riverpod 3配合代码生成机制管理应用状态。当你需要创建Provider、编写异步逻辑,或开发有状态的功能时,可选用此方法。

SKILL.md
--- frontmatter
name: riverpod-state
description: Manages application state using Riverpod 3 with code generation. Use when creating providers, async logic, or stateful features.

Riverpod State Management Skill

Follow Riverpod 3 best practices using generated providers.

When to use this skill

  • Adding new state
  • Fetching async data
  • Managing user/session state

Conventions

  • Prefer @riverpod generators
  • Name providers by responsibility, not type
  • Keep providers small and composable

Patterns

Async data

  • Use AsyncValue<T>
  • Handle loading/error in UI, not provider

Side effects

  • Perform mutations inside notifier methods
  • Never mutate state directly in widgets

File naming

  • *_provider.dart
  • *_notifier.dart

Anti-patterns to avoid

  • Reading providers inside constructors
  • Large monolithic providers
  • Business logic in widgets