用途
该技能用于在代码审查、质量讨论、重构或检查反模式时,激活一套项目特定的代码质量规范与审查清单,帮助团队在 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 技术栈;其他项目或框架可能需要调整。详细模式需参考仓库中的指令文件。