用途:在 PR 审查前、功能完成后或需要检查可维护性时,对 Flows 应用(或指定 $ARGUMENTS)进行代码质量审查,按顺序执行各步骤并报告所有发现,附文件路径与行号。
主要能力与流程:
- 先跑自动化基线:pnpm run lint 与 pnpm exec tsc --noEmit,列出全部错误和警告,lint 错误必须先修复。
- TypeScript 类型安全:用 grep 搜索 any 用法并替换为正确类型;用品牌类型、可辨识联合替代标志位组合;让类型端到端流动,优先用 Pick、Omit、Parameters、ReturnType、Awaited、typeof 派生;两个以上同类型原始参数改为命名属性对象。
- 组件规模与单一职责:统计 .tsx 行数,超过 150 行的组件需检查是否职责过多,可提取自定义 hook 或子组件,但不为行数而拆分。
- 消除重复逻辑:搜索重复的 fetch、格式化、className 模式,按纯函数、hook、共享组件分别提取到 src/utils/、src/hooks/ 或共享组件。
- 外部调用依赖注入:组件和 hook 不得直接构造 CDF 客户端,应通过 useCogniteClient() 或 prop 获取。
- 编码模式与可测试性:hook 通过 React context 注入依赖;服务类实现显式接口;页面级 hook 采用 ViewModel 模式分离业务逻辑与展示;检查 vi.mock 与 as unknown as 的使用。
- 命名规范:文件与目录 kebab-case,组件 PascalCase,变量与 hook camelCase,模块级常量 SCREAMING_SNAKE_CASE,布尔变量用 is/has/can 前缀。
- 清理死代码:移除 console.log/debug、注释掉的代码块、过期的 TODO/FIXME,查找未使用文件与不可达页面,这些为阻塞项。
- 文件与导出结构:按 components、hooks、utils、contexts、pages/views、types 组织,组件目录提供 index.ts。
- 输出结构化报告,按类别汇总发现数量并列出最高优先级项;any 类型和 lint 错误视为阻塞项单独列出。
限制:该技能面向 Flows 应用与 TypeScript/React 技术栈,依赖 pnpm、tsc 与 grep 等工具;资料未提供具体收费、平台支持范围或效果保证。