用途:对 Flutter 项目执行全面健康审计,按顺序执行 11 条独立可复用的分析规则,最终汇总生成报告。
主要能力:仓库结构清单检测;核心配置文件与国际化的读取分析;GitHub Actions 等 CI/CD 工作流分析;测试基础设施分类与覆盖率验证;linter 与代码质量分析;技术文档与环境搭建说明检查(不含运维/runbook 内容);计算各章节 0-100 分与加权总分;识别技术风险与技术债;生成含执行摘要、评分卡、8 个详细章节、附加指标、质量指数、风险与机会、优先级建议及证据索引的报告。
使用方式:审计前必须先执行强制步骤 0,用 FVM 对齐全局 Flutter 版本并安装全部依赖,含根项目、packages 与 apps;相关命令如 fvm flutter pub get、fvm flutter pub deps、fvm dart run build_runner build --delete-conflicting-outputs。随后依次执行 references 目录下的规则文件。第 8 步导出报告:mkdir -p reports,内容保存至 ./reports/flutter_audit.txt,为纯文本格式,适合复制进 Google Docs,不使用 markdown 语法。第 9 步须先询问用户是否执行 /somnio:flutter-best-practices,不得自动执行。
适用场景:Flutter 项目(含 monorepo)的技术健康评估与成熟度审查。
限制:仅关注技术层面,不给出 CODEOWNERS、SECURITY.md 等治理建议,也不涉及运维文档;证据缺失时标记 Unknown,不编造数据;MANDATORY 步骤失败立即停止;安全分析需单独运行 /somnio:security-audit。