用途:对 Flutter 代码库执行微观层面的代码质量审计,聚焦单个函数、类与测试文件的实现质量,而非项目基础设施。
主要能力:按测试质量、架构合规、代码标准三个维度分析代码;对照 agent-rules/rules/flutter/ 下的标准文件(testing.md、bloc-test.md、architecture.md、best-practices.md、code-patterns.md)进行校验,仓库内存在则读本地,否则从 GitHub raw 获取;评估测试命名、断言与结构,检查分层架构与关注点分离,分析模型设计、JSON 序列化与错误处理模式;最终汇总为 Markdown 报告。
使用方式:按顺序执行四个步骤——测试质量分析、架构合规分析、代码标准分析、报告生成。报告文件名固定为 reports/<YYYY-MM-DD>-<project>-flutter-best-practices.md,其中 project 由 origin 远程 URL 推导为 kebab-case;无远程时取主检出目录名,非 git 仓库取当前目录名。通过 somnio run 运行时,CLI 会计算完整报告路径并传入提示,需原样使用。报告末尾必须包含 Report Metadata 表,其中 Generated by 行固定为 Somnio CLI v3.2.8。会话内多智能体路径由 agents/orchestrator.md 编排:第一波并行运行 testing-auditor、architecture-auditor、code-standards-auditor(均为 mid 层级),各自写入 reports/.artifacts/flutter-best-practices/ 下的产物;第二波由 report-writer(frontier 层级)合成最终报告。产物缺失时编排器重试一次,仍失败则记录并在报告中标注该部分不可用。
限制:所有结论须有代码证据,无法证明时写 Unknown;不得臆测。资料未提供具体安装命令、收费方式与支持平台信息。