SuperAPI AI 工具集

flowr-usage

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:指导在纯 Dart 或 Flutter 项目中正确使用 FlowR。

准备工作:先解析目标包,命令为 uv run --script .agents/skills/flowr-usage/scripts/resolve.py --task auto。每个 instructions_id 只读一次解析出的指令。所有自带 Python 入口都用 uv run --script <path> 运行;用 uv add --script <path> <dependency> 增改 PEP 723 依赖;禁止用 python、python3 或 uv run python 调用。

路由选择:auto 为常规入口,读取最近的 pubspec.yaml。仅直接依赖 flowr_dart 且无 Flutter SDK 依赖的包解析为 core;直接依赖 flowr 且声明 Flutter SDK 依赖的解析为 flutter,先加载 core 规则再加载 Flutter 规则与可选项目配置。flowr 无 Flutter SDK 依赖属无效,应修正目标包而非降级为 core。--task core 与 --task flutter 为显式路由;解析器会拒绝为纯 Dart 包指定 flutter。

通用规则:遵循仓库 AGENTS.md 并保留既有架构;每种路由都读 core 指令,Flutter 指令是扩展而非替换;只导入公开包入口,不得从应用代码导入 flowr/src/... 或 flowr_dart/src/...;此处只管包 API 用法,文件布局、组件归属与契约由调用方架构技能负责。

参考文档按需加载:core.md、flutter.md、flowr-dart-install.md、flowr-install.md、flowr-logging.md、flowr-run-catching.md、flowr-slowly.md、flowr-disposal.md、flowr-update.md、flutter-error-boundaries.md、bloc-concurrency.md、freezed-install.md、slang-install.md、fr-mvvm-locale-slang.md、fr-provider-di.md、fr-vm-communication.md、fr-union.md 及 fr-mvvm-* 等。不要默认添加 bloc_concurrency。

验证:用包配置的 Dart/Flutter 工具格式化改动的 Dart 文件;运行目标包的聚焦测试;共享 API 或包接口变更时运行仓库分析命令。

限制:资料未提供 FlowR 的收费、价格、平台支持或效果说明;未提供具体代码示例。