fr

Relay-v3 Lua 状态机接入指南。新增一个互联网房间业务（聊天、卡牌、白板、投票、协作…）时使用。描述后端元函数契约、前端闭环套路、Lua 脚本模板、state 转换规范、错误案例。识别"我要实现一个新业务""写一个 Lua 房间脚本""加一个 action 类型"时触发。

当用户提及 Relay/LAN/快照/action 流/net_p2p/net_engine 协议、讨论消息传输层（事件 vs 快照）、新建/重构 P2P 协议、排查"晚加入者错过事件""两端不同步""房间状态丢失""广播丢失"等问题时触发。包含 v1 action/事件驱动（已落地，遗留用法）与 v2 快照驱动（推荐新功能）。

Flutter 项目中"样式"相关工程的渐进式披露指南。当用户要做 UI 样式选型、视觉对齐复刻、画布/HTML mockup 与 Flutter 实现的双向对照、或在 Material 3 体系下选某一类样式（顶部 App Bar / Card / Button / NavigationBar / Modal 等）落地时触发。本 skill 是样式大类的总入口，所有方案的最终形态都登记在分类索引表里，按需加载对应方案文件。同时承载小豆子 FR 项目的 UI 设计原则与实战 bug 沉淀（border-emphasis 边框强调式、嵌套 sheet race condition、多风格 lottery 投票挑选、纯色按钮减负、左重右轻、装饰性 vs 功能性颜色决策）。

flutter的开发操作流程,在dart-flutter任何问题都需要优先加载这个SKILL

Flutter 通过 home_widget 把 1Hz 实时值（如倒计时）推到 Android 桌面 AppWidget 的端到端架构。当用户提到 home_widget 不同步、桌面小组件不刷新、appwidget 实时值、widget 显示卡死、widget 进程被杀场景、AppWidgetProvider 找不到时触发。

Comprehensive Rive animation platform skill covering scripting (Luau), runtime integration (React/Next.js), state machines, data binding, and the complete API. Use this skill when users need to create interactive animations with Rive, integrate Rive into React/Next.js applications, write Rive scripts (Node, Layout, Converter, PathEffect protocols), control animations via state machines, implement scroll-based animations, or work with Rive's drawing API (Path, Paint, Renderer). Triggers on: "rive", "rive animation", "rive script", "luau", "@rive-app/react-canvas", "state machine animation", "interactive animation", "scroll animation with rive". 本项目（xiaodouzi/fr，Flutter + rive ^0.14.5）特化：DataBind / ViewModel 双向数据绑定、lab demo 添加流程见 references/flutter-databind-0.14.md 与 references/flutter-project-workflow.md。

Android 14+ MediaProjection 截屏与 Foreground Service 调试修复指南。当遇到悬浮窗截屏闪退、权限重复申请、SecurityException、IllegalArgumentException、Unable to start service、截图后无结果显示、设备运行旧 APK 等问题时使用此 skill。涵盖 MediaProjectionManager、startForeground、FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION、ImageReader/VirtualDisplay 等完整调试链路；按异常类型分类的排查 SOP 见 references/fgs-debug-cases.md。当用户提到 MediaProjection、截屏权限、前台服务类型、悬浮窗截图、FOREGROUND_SERVICE_MEDIA_PROJECTION、Foreground Service type 不匹配、Android 14+ 屏幕录制、SecurityException around startForeground、PigmentFloatingManager、悬浮窗 FGS 异常，或任何 Android 14+/15 foreground service 与 MediaProjection 相关问题（含设备运行 APK 与源码不一致）时触发。

Fork 模式下，把当前分支领先 upstream/master 的多个 commit 压缩成一个， 推送到 `upstream` 远端，再 `gh pr create` + `--squash` 合并到主分支的端到端 SOP。 触发场景：用户说"压缩领先 commit 再发版"、"squash 后推到 upstream 然后 PR"、 "用 gh 推到 upstream master"、"把当前分支发版"、"open PR against upstream"、 明确给出 squash + push + gh pr create 序列时。 适用前提：本地有 `origin`（自己的 fork）和 `upstream`（canonical 仓库）两个 remote； 当前分支相对 `upstream/master` 已有 N 个领先 commit（N ≥ 1）。

小豆子 FR 的 lib/api/ 模块规范 — 目录即后端、深目录轻文件、全局拦截器链

阅读任意目录，分析模块结构，生成防腐蚀规范 skill（不生成孤儿文档）

当用户询问块编辑器、结构化笔记、Notion-like编辑器、 笔记核心架构、Block模型、sealed class BlockType、 RichText/Span/InlineFormat、笔记持久化、Demo页面实现、 工具栏添加新工具、输入类型转换、Markdown导入、 BlockWidgetStrategy、编辑器模式装饰、Enter行为策略、 core目录结构、选中高亮行为时触发。

当用户要求实现 WebRTC 视频通话、设计 P2P 实时通信系统、搭建 WebRTC 信令基础设施、实现音视频传输或 DataChannel 数据传输时触发。提供从信令协议设计到移动端优化的完整架构指南。

Flutter消息策略模式工作流程。添加新消息类型到message_strategy系统时使用。包括创建IMessageData、MessageWidgetStrategy、注册DI、创建mock数据。type由数据层定义。交互型消息(输入/选择)需要内部State，使用_StatefulWidget子widget模式。确认后锁定UI状态。

Flutter Hive 存储管理调试和最佳实践。当遇到 Hive 存储相关问题时要使用此 skill： - body_records 或其他使用 TypeAdapter 的 HiveObject 无法读写 - 删除 Hive 数据失败 - Hive box 类型不匹配错误 - StorageManager 查看数据显示 "Instance of xxx" - 任何 Hive box 打开/访问问题

PR管理工作流。当用户提到合并PR、查看PR、检查PR时使用此技能。

Android自适应图标前景图处理工作流。当用户提到图标处理、应用图标、自适应图标、安卓图标、app icon、adaptive icon、foreground icon时使用此技能。完成从原始图片到Android自适应图标前景图的完整处理流程，包括：边缘色块分析、洪泛法去色、岛屿算法提取中心内容、HLS饱和度过滤、图标居中缩放、以及Android adaptive icon XML配置。

Use when encountering errors or unexpected behavior in Flutter that needs investigation through strategic logging