agent-plugins 中 hot_reload 规则实战：让 AI 自动连接应用并热重载的完整指南
【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins
agent-plugins 是 Flutter 团队官方维护的 AI 智能体插件集，而其中的hot_reload 规则正是它的"杀手锏"：只需一行 Markdown 配置，就能让 AI 在每次修改 Dart/Flutter 文件后，主动连接正在运行的应用并自动触发热重载（hot reload），无需你手动操作，代码改完即见效果。
hot_reload 规则是什么？
hot_reload 规则本质上是一份"行为指令"，存放在项目的 rules/hot_reload.md 中，全文只有寥寥数行：
--- trigger: glob globs: *.dart description: Proactively connect to apps and hot reload --- Whenever you make edits to any Dart or Flutter files in this project: 1. Proactively connect to the running application using the `dtd` tool and its subcommands. 2. Trigger a hot reload using the `hot_reload` tool to push the changes immediately. 3. If no app is running, inform the user but do not let it stop you from completing the code edits.文件开头的frontmatter声明了触发条件：globs: *.dart表示只要 AI 编辑匹配*.dart的文件，这条规则就会被激活。
💡 项目里还有一份 rules/hot_reload.mdc——
.mdc是 Cursor 的规则格式（使用globs+alwaysApply: false字段），两者内容一致，分别适配不同的 AI 智能体。这正是 agent-plugins "一次安装、多端通用"的设计思路。
规则让 AI 执行的 3 个关键步骤
这条规则看似简单，实则定义了 AI 完整的"修改—推送—兜底"闭环：
| 步骤 | 动作 | 工具 |
|---|---|---|
| 1️⃣ 主动连接 | 先读取工具 schema，再连接正在运行的应用 | dtd |
| 2️⃣ 热重载 | 立即把代码变更推送到应用 | hot_reload |
| 3️⃣ 优雅兜底 | 没有应用运行时提示用户，但不中断代码编辑 | — |
其中第 3 条最容易被忽略，却决定了 AI 的"职业操守"：即使没有可连接的运行实例，AI 也不会罢工，而是继续完成代码修改并告知你——规则永远优先保证任务不被阻塞。
为什么能自动连接应用？规则与 MCP 的分工
单靠规则文件还不够，真正干活的是 MCP（Model Context Protocol）服务器。agent-plugins 通过 .mcp.json 注册了 Dart 官方 MCP 服务：
{ "mcpServers": { "dart-mcp-server": { "command": "dart", "args": ["mcp-server"] } } }两者的分工非常清晰：
- MCP 服务器提供"手"：
dtd、hot_reload、get_runtime_errors等工具； - hot_reload 规则提供"脑"：告诉 AI什么时候该用这些工具、按什么顺序用。
正如项目 README.md 所说：MCP 给智能体提供专用工具，而 Skill/Rule 教会它如何为特定任务使用工具。hot_reload 规则就是最典型的"教会 AI 何时按下热重载按钮"的例子。
实战场景：改一行代码，应用立刻刷新
想象这个日常流程：
- 你启动应用，让 AI"把按钮颜色改成蓝色"；
- AI 编辑
*.dart文件 → hot_reload 规则自动触发； - AI 用
dtd连接运行中的应用，调用hot_reload推送变更； - 数秒后，屏幕上的按钮已经变蓝——全程你只说了一句话。
这个能力在调试闭环中价值巨大。例如 skills/dart-fix-runtime-errors/SKILL.md 描述的排错流程就依赖它：AI 通过get_runtime_errors抓取运行时堆栈 → 定位失败行 → 修复代码 →通过 hot_reload 验证问题是否真正解决，形成"修改—热重载—再验证"的自动化反馈回路，而不需要你反复手动r一下应用。
如何把 hot_reload 规则装进你的项目
agent-plugins 支持多种智能体，安装方式见 README.md：
通用方式（推荐，放入标准.agents/skills目录）：
npx skills@1.5.17 add flutter/agent-plugins --skill '*' --agent universal --yesClaude Code / Codex 插件市场方式：
claude plugin marketplace add flutter/agent-plugins codex plugin marketplace add flutter/agent-plugins安装后 AI 会自动获得 skills/ 下的全部技能与 rules/ 下的 hot_reload 规则。日后升级只需执行npx skills@1.5.17 update。
常见疑问 FAQ
Q1：应用没在运行，AI 会报错卡死吗？不会。规则第 3 条明确要求：告知用户"没有可连接的应用"，但继续完成代码编辑。
Q2：.md和.mdc两份文件会重复触发吗？不会。它们是同一规则在不同编辑器/智能体规则格式下的映射——Cursor 读.mdc，其他智能体读.md，各取所需。
Q3：规则只对项目内*.dart生效吗？是的，globs: *.dart限定了触发范围，不会对你随手修改的 README 之类文件误触发热重载。
小结
hot_reload 规则用不到 10 行文字，把"改完代码记得热重载"这件重复劳动彻底交给了 AI：MCP 提供连接应用与推送变更的能力，规则定义触发时机与行为边界，二者配合让 AI 具备了"改完即生效"的完整开发闭环。如果你正在用 AI 智能体开发 Flutter/Dart 项目，这一条规则值得立刻启用——少一次手动刷新，就多一分开发心流。
【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
