SuperAPI AI 工具集

flutter-read-logs-usage

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:本技能用于说明 flutter-read-logs 插件能做什么、何时使用它,以及在需要时引导完成配置。当用户调用 /flutter-read-logs-usage、询问该插件覆盖范围,或已有具体读日志任务时使用。

主要能力:通过 /read-logs <task>,让模型按需读取正在运行应用的最新 flutter run 输出,替代手动粘贴终端日志。日志按项目捕获到 /tmp/flutter-<repo>.log,借助 --git-common-dir 保持 worktree 稳定,每次启动覆盖写入。支持两种格式并自动识别:Zed 脚本会话记录和 VS Code/Cursor dapLogFile(DAP)。读取以任务为导向:短日志整体读取,长日志则围绕具体问题(错误、事件顺序、某个功能等)调查;会标记过期运行,首次使用时引导编辑器配置。

适用场景:应用为何在运行时崩溃或出现某种行为;认证流程是否真正到达 API;追踪事件触发顺序(竞态/时序问题)。

使用方式:若用户未给出具体任务,先解释插件作用及何时使用 /read-logs;若需要配置,指向该插件的 README.md(规范的配置说明所在),VS Code/Cursor 使用 dapLogFile(保留 F5 工作流),Zed 使用脚本包装的运行任务;若已有具体任务,简要说明适配性后运行 /read-logs。不要先回复“skill loaded”或“ready for the task”之类的填充语。配置为每位开发者一次性操作,首次在无日志文件时 /read-logs 也会引导配置并可代为应用。

限制与注意:运行日志可能包含令牌和客户数据,/read-logs 会把读取内容发送给模型,请参阅 README.md 中的警告。相关插件 flutter-marionette 是主动式对应工具,通过 MCP 与实时应用交互;要让事情发生用它,要检查某次运行已记录的内容(包括 marionette 因需实时连接而看不到的崩溃/构建错误)用 /read-logs。