用途:对 AngularJS(Angular 1.x)代码库执行微层面代码质量审计,聚焦单个控制器、指令、.component() 单元、服务与测试文件的实现质量,同时校验测试、模块/组件架构、作用域与绑定、服务与数据流、摘要循环性能以及压缩安全 JavaScript 规范。
主要能力:
- 测试质量:Karma/Jasmine 与 angular-mocks(module()/inject()/$httpBackend)、命名约定、断言、异步处理与 Arrange-Act-Assert 结构。
- 组件架构:按功能划分模块、controllerAs、.component() 与指令选择、隔离作用域、单文件单定义。
- 作用域与绑定:bindToController、单向/文本/表达式绑定、生命周期钩子($onInit、$onChanges、$onDestroy、$postLink)、$watch 与销毁清理。
- 状态管理:服务/工厂分层、$http 与拦截器、$rootScope 使用纪律。
- 性能:$watch 成本、一次性绑定(::)与单向绑定(<)、ng-repeat track by、$sce 与模板过滤器。
- JavaScript 规范:压缩安全 DI($inject、内联数组、ng-annotate)、IIFE 与 'use strict'、JSHint/ESLint。
使用方式:按顺序执行 7 个步骤并使用对应 references 文件;标准来源为仓库内 agent-rules/rules/angularjs/,否则从 GitHub raw 拉取。在 Claude Code 会话中由 orchestrator 分三波调度子代理并将制品交给 report-writer。报告文件名固定为 <YYYY-MM-DD>-<project>-angularjs-best-practices.md,通过 somnio run 运行时须使用 CLI 给出的路径。报告末尾必须包含报告元数据表,其中 Generated by 固定为 Somnio CLI v3.2.8。
限制:仅面向 Angular 1.x 旧范式,按该范式内的结构优劣评判,而非以现代框架标准否定;仅分析实现质量而非基础设施;缺证据时报告 Unknown;未提供具体版本要求、收费信息或运行环境细节。