flowr-usage

FlowR 用法

开始 FlowR 工作前，先解析目标包：

uv run --script .agents/skills/flowr-usage/scripts/resolve.py --task auto

每个 instructions_id 只需读取一次已解析的指令。

使用 uv run --script <path> 运行所有捆绑的 Python 入口点。使用 uv add --script <path> <dependency> 添加或更新其 PEP 723 依赖项；切勿使用 python、python3 或 uv run python 调用捆绑脚本。

路由选择

• auto 是常规入口。它会读取最近的 pubspec.yaml。
• 直接依赖项仅包含 flowr_dart 且没有 Flutter SDK 依赖项的包会解析为 core。它不会加载任何 Flutter 或 flowr 内容。
• 直接依赖 flowr 且声明了 Flutter SDK 依赖项的包会解析为 flutter。它会先加载核心规则，然后加载 Flutter 规则和可选的项目配置文件。
• 没有 Flutter SDK 依赖项却使用 flowr 是无效的。请修复目标包；不要静默降级到核心路由。
• --task core 和 --task flutter 是显式路由。对于仅包含 Dart 的包，解析器会拒绝 flutter。

通用规则

• 遵循仓库的 AGENTS.md，并保留现有架构。
• 对所有已解析的路由都读取核心指令。Flutter 指令是在核心规则基础上扩展，而非取代核心规则。
• 仅导入公开的包入口点。应用代码不得从 flowr/src/... 或 flowr_dart/src/... 导入内容。
• 在此处处理包 API 的用法。文件布局、组件归属和契约决策仍由调用方的架构技能负责。

参考资料

仅加载与任务相关的参考资料：

• references/core.md：FlowR/FlowB、日志记录、状态、流、调度和释放规则。
• references/flutter.md：FrViewModel、FrBlocViewModel、FrProvider、FrView、监听器和 Flutter 归属规则。
• references/flowr-dart-install.md：将 flowr_dart 添加到纯 Dart 包。
• references/flowr-install.md：添加 flowr 和首个 Flutter provider/view。
• references/flowr-logging.md、flowr-run-catching.md、flowr-slowly.md、flowr-disposal.md、flowr-update.md：对应名称所指的核心关注点。
• references/flutter-error-boundaries.md：在 Flutter 应用入口点安装互补的 FlutterError、PlatformDispatcher 和 zone 边界，同时保留本地 logE 恢复日志记录。
• references/bloc-concurrency.md：评估并配置异步 FlowB 或 FrBlocViewModel 处理器的每处理器事件并发。当重叠事件可能引发竞争、重复工作、过期结果，或需要按顺序处理时加载此资料；默认不要添加 bloc_concurrency。
• references/freezed-install.md：添加不可变 Freezed 状态生成。
• references/slang-install.md：安装并生成类型安全的 slang 翻译；项目约定使用 S.。
• references/fr-mvvm-locale-slang.md：将 slang 翻译目录与作为应用区域设置所有者的 fr_mvvm_locale 集成。
• references/fr-provider-di.md、fr-vm-communication.md、fr-union.md：Flutter 高级 provider、VM 协作和 FrUnion 用法。
• references/fr-mvvm-*.md：相应的可选 Flutter 扩展。

验证

• 使用包配置的 Dart/Flutter 工具格式化已更改的 Dart 文件。
• 对目标包运行有针对性的测试。
• 共享 API 或包接口发生变化时，运行仓库的分析器命令。