SuperAPI AI 工具集

code-quality

编程与开发

查看项目

更新于 10-19 18:19

技能介绍

用途

该技能用于在代码审查、质量讨论、重构或检查反模式时,激活一套项目特定的代码质量规范与审查清单,帮助团队在 Angular 项目中保持一致的高质量标准。

主要能力

清单分为三个层级:关键违规(必须修复)、警告(应当修复)以及 Lint 与格式检查。

关键违规(必须修复)

  • 禁止 barrel 文件(index.ts)
  • 组件必须位于自己的子文件夹中
  • 遵守 DDD 边界(禁止跨域导入)
  • 每个组件必须使用 standalone: true + OnPush
  • 使用 Signal 输入(input())和输出(output()),而非装饰器
  • 使用 @if/@for/@switch 控制流,绝不使用 *ngIf/*ngFor
  • 使用 inject() 函数,而非构造函数注入
  • 禁止 any 类型——严格 TypeScript
  • 文件使用 kebab-case,类使用 PascalCase 且不带类型后缀

警告(应当修复)

  • @for 必须包含 track 表达式
  • 重计算应放在 computed() 中,而非模板中
  • 每个新文件应有对应的 .spec.ts 测试文件
  • 所有测试中使用 provideZonelessChangeDetection()
  • Store 使用 rxMethod + tapResponse 处理异步
  • 一致地管理加载/错误状态

Lint 与格式

命令如下:

npm run lint          # ESLint + auto-fix
npx prettier --check . # Check formatting

使用方式

当进行代码审查、讨论代码质量、重构或检查反模式时,该技能会被激活,并依据上述清单提供指导。详细模式可阅读 .github/instructions/ 中的指令文件。

适用场景

适用于 Angular 项目的代码质量审查、重构指导、反模式检查以及团队规范落地。

限制

该清单为项目特定规范,主要针对 Angular 技术栈;其他项目或框架可能需要调整。详细模式需参考仓库中的指令文件。