用途:这是一个只读的 Flutter 代码库侦察方法,适合在接触陌生 Flutter 项目、或在动手改动前先搞清项目现状时使用,也适合用户询问“这个代码库在做什么”。原则是发现阶段绝不修改文件,所有结论作为后续规划与实现的基础。
主要能力与步骤:先确认工作目录存在 pubspec.yaml,若缺失则明确告知“这不像 Flutter 项目”,检查是否含 flutter: 段以区分普通 Dart 包;读取 pubspec.yaml 提取名称、描述、版本、Dart/Flutter SDK 约束、依赖与开发依赖、Material、assets、fonts,并标记精确版本、path: 与 git: 依赖及国际化使用;读取 analysis_options.yaml 判断 lint 严格度;两级查看 lib/ 判断架构模式(feature-first、分层、扁平、MVC/MVVM)并检查 main.dart;统计 test/ 与 integration_test/ 下 *_test.dart 数量以估算测试信号;检查 Android 与 iOS 配置及自定义原生代码;识别路由(GoRouter、AutoRoute、命名路由或临时式);识别状态管理(Riverpod、Bloc、Provider、GetX、MobX 或仅 setState),多库混用会标为不一致;检查依赖隐患、硬编码凭据、TODO/FIXME/HACK/XXX 与 print 语句。
使用方式:按上述步骤逐项执行,最后输出包含项目概览、架构、关键依赖、测试信号、平台说明、代码质量信号、风险与建议下一步的结构化报告;仅在用户明确要求持久化时写入 docs/audit/codebase_discovery.md。
限制:全程只读、不做修复,也不在发现阶段给出架构建议;文件不可读时说明未知而不猜测;若无 pubspec.yaml 立即停止;工作目录不明确时先询问。具体命令与更多细节暂未提供。