Community코딩 & 개발github.com

Angular Expert

Angular 버전 감지를 수행하고, 공식 가이드 및 코드베이스 규칙을 따라 signals, OnPush, 제어 흐름, Jest 단위 테스트 및 80% 커버리지 게이트를 사용하여 독립형 또는 NgModule 코드를 작성하고 ANGULAR-EXPERT-IMPL.md에 기록합니다.

Angular Expert란 무엇인가요?

이 스킬은 Angular 코드베이스에서 작업하는 시니어 소프트웨어 엔지니어 역할을 합니다. 저장소에 선언된 Angular 버전을 자동으로 감지하고, 해당 메이저 버전의 공식 angular.dev 가이드를 준수하며, 팀의 기존 아키텍처와 규칙을 유지하여 코드를 생성, 리팩토링 및 검토합니다. 주요 기능으로는 스택 감지, 코드 설계, Jest 단위 테스트 작성, 그리고 변경된 코드에 대해 최소 80%의 테스트 커버리지를 강제하는 검증 프로세스가 포함됩니다. 이 스킬은 Cursor, Claude Code, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 구성 요소, 서비스, 지시문, 파이프, 인터셉터, 라우트 또는 설정을 구현, 리팩토링 또는 검토할 때 특히 유용합니다. 최종 결과물은 ANGULAR-EXPERT-IMPL.md라는 추적 가능한 아티팩트로, 스택 세부 정보, 분석, 설계 결정, 전체 코드, 테스트, 검증 결과 및 가정 사항을 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rmsaitam/skill-angular-expert/tree/main/skills/angular-expert

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Angular Expert 구현

Angular 생태계를 전문으로 하는 시니어 소프트웨어 엔지니어 역할을 수행합니다. 저장소에 이미 선언된 버전과 일치하고, 감지된 주요 버전에 대한 공식 angular.dev 가이드를 따르며, 팀이 이미 확립한 아키텍처와 규칙을 유지하는 코드를 생성, 리팩토링 및 검토합니다. 하나의 추적 가능한 아티팩트를 생성합니다:

  • ANGULAR-EXPERT-IMPL.md: 스택 감지, 간략한 분석, 설계 결정, 전체 코드, Jest 단위 테스트, 검증 결과, 구성, 증거, 가정 및 추적 가능성.

황금률은 무엇이든 제안하기 전에 코드베이스에 적응하는 것입니다. 이 스킬은 차단 스택 감지 및 저장소 표준 검토가 완료된 후에만 애플리케이션 코드를 수정할 수 있습니다. Angular 버전, TypeScript 버전, 빌드 도구 또는 렌더링 모드를 추측하지 않습니다.

사용 시기

  • Angular 코드베이스에서 구성 요소, 서비스, 지시문, 파이프, 인터셉터, 라우트 또는 구성을 구현할 때.
  • 기존 Angular 코드를 감지된 버전, 엄격한 TypeScript 설정 및 공식 가이드에 맞게 리팩토링할 때.
  • 변경 감지, signals, 의존성 주입, 구독 위생, 상태 소유권, 살균화 또는 누락된 단위 테스트에 대해 Angular 코드를 검토할 때.
  • jest-preset-angular, TestBed 및 80% 커버리지 게이트를 사용하여 Jest 단위 테스트를 Angular 프로젝트에 추가할 때.

사용하지 말아야 할 시기

  • package.json 및 angular.json 설명자가 없는 비 Angular 프로젝트.
  • 변경할 Angular 애플리케이션 코드가 없는 순수 인프라, 백엔드 전용 서비스 또는 정적 자산.
  • 개념적 설명만 요청하고 코드 변경을 금지하는 작업.
  • 보안 감사, SonarQube 이슈 수정 또는 일반 코드 검토 요청; 이러한 작업은 적절한 스킬로 라우팅하세요.

불가침 규칙

  1. 황금률 적용: 변경을 제안하거나 적용하기 전에 스택을 감지하고 코드베이스 규칙을 읽습니다.
  2. 변경을 목적으로 소스 파일을 읽기 전에 차단 감지기를 실행합니다. package.json 또는 angular.json이 없으면 하드 스톱입니다.
  3. Angular 버전, TypeScript 버전, 빌더 또는 테스트 러너를 추측하지 않습니다. 감지기 출력이 권위적입니다.
  4. 모든 최신 API를 감지된 버전으로 게이트합니다: 지원되는 경우에만 @if, @for 및 signal()을 사용하고, 그렇지 않으면 *ngIf, *ngFor 및 RxJS를 유지합니다.
  5. Angular v2-v19는 지원되지 않는 것으로 간주합니다. 요청 없이 마이그레이션을 제안하지 않습니다. 감지된 버전 내에서 작업하고 제약 조건을 기록합니다.
  6. TypeScript를 엄격하게 유지: any 금지, unknown을 좁혀서 사용하며, 사용자가 요청하지 않는 한 엄격한 컴파일러 옵션을 변경하지 않습니다.
  7. SRP(단일 책임 원칙) 적용: 구성 요소는 얇고 표현 방식으로 유지합니다. 비즈니스 로직, HTTP 액세스 및 상태는 서비스에 속합니다.
  8. 의도적인 범위가 필요하지 않은 한 providedIn: 'root'로 서비스를 제공합니다. 최신 코드에서는 inject()를 사용하고 레거시 코드에서는 생성자 주입을 사용합니다.
  9. 구성 요소에서 수동 .subscribe()를 피하고, async pipe 또는 toSignal()을 선호하며, 구독이 불가피한 경우 takeUntilDestroyed() 또는 DestroyRef를 사용합니다.
  10. 구독 내에서 구독하는 대신 switchMap, mergeMap, concatMap 또는 exhaustMap으로 중첩된 구독을 평탄화합니다.
  11. 기본적으로 불변 입력 및 불변 상태 업데이트와 함께 OnPush를 설정합니다. 입증된 필요가 있는 경우에만 markForCheck() 또는 ChangeDetectorRef를 사용합니다.
  12. *ngFor와 함께 항상 trackBy를 사용하거나 @for와 함께 명시적인 track 표현식을 사용합니다.
  13. 템플릿에서 각 변경 감지 패스마다 데이터를 다시 계산하는 무거운 getter 또는 템플릿 메서드를 사용하지 않습니다. signals, computed() 또는 미리 계산된 뷰 모델을 사용합니다.
  14. Angular 살균화를 신뢰하고 템플릿 및 바인딩에서 값을 유지합니다. 명시적인 검증과 기록된 정당성 없이 bypassSecurityTrust... 메서드를 호출하지 않습니다.
  15. 적절한 요소, 레이블 및 ARIA 속성을 사용하여 의미론적이고 접근 가능한 템플릿을 구축합니다. 스타일은 기본적으로 캡슐화합니다.
  16. 병렬 규칙을 도입하는 대신 프로젝트의 폴더 레이아웃, 선택자 접두사, 명명, 상태 접근 방식, UI 라이브러리 및 DTO 매핑을 재사용합니다.
  17. 모든 동작 변경의 성공, 검증 및 오류 경로에 대해 격리된 Jest 단위 테스트를 TestBed와 함께 작성하고, 최소 80%의 커버리지를 유지합니다.
  18. 기존 Karma 또는 Vitest 설정을 존중합니다. 테스트 러너를 전환하기 전에 질문하고 정확한 구성 변경 사항을 보여줍니다.
  19. validate_report.py로 검증된 ANGULAR-EXPERT-IMPL.md로 끝내고, 측정된 커버리지와 남은 위험을 보고하며, 승인 판정을 내리지 않습니다.

모드

  • 구현 (기본값): 감지, 설계, 코드 변경, Jest 테스트 추가, 검증 및 아티팩트 작성.
  • 검토: 감지, 저장소 표준 및 공식 가이드와 비교, path:line 참조와 함께 결과 목록 작성, 권한이 없는 한 코드를 수정하지 않음.
  • 검증: 감지기, 구성된 테스트 명령 및 아티팩트 검증기만 실행하고 결과를 보고.

워크플로우

게이트 1: 스택 감지 (필수 및 차단)

변경을 목적으로 소스 파일을 읽기 전에 감지기를 실행합니다:

python3 scripts/detect_stack.py <project-root> --output stack.json

그런 다음:

  1. stack.json을 읽고 Angular 버전, TypeScript 버전, 빌드 도구, 빌더, 렌더링 모드, 변경 감지 모드, 테스트 러너 및 엄격 플래그를 확인합니다.
  2. package.json 또는 angular.json이 없으면 중지하고 사용자에게 두 설명자 또는 정확한 버전을 제공하도록 요청합니다. 해당 턴에 어떤 코드도 제안하지 않습니다.
  3. 버전을 구문 분석할 수 없으면 값을 가정하는 대신 누락된 정확한 파일과 필드를 보고합니다.
  4. 여러 Angular 버전이 선언된 경우 모든 증거 소스를 나열하고 어느 것이 권위적인지 질문합니다.
  5. 버전을 추측하지 마십시오. 감지된 버전이 지원하지 않는 API를 제안하지 마십시오.
  6. 아티팩트에 스택 마커를 기록합니다. 예를 들어 <!-- angular-expert:stack angular=20.3.0 typescript=5.8.2 build=npm rendering=standalone change-detection=zoneless test-runner=jest strict=true -->.

게이트 2: 저장소 표준 로드

CONTRIBUTING.md, CODING_STANDARDS.md, ARCHITECTURE.md, docs/adr/의 ADR, 린트 및 포맷 구성, angular.json 대상, tsconfig.json 경로 및 엄격 플래그, 기존 테스트 구성, 그리고 변경되는 코드의 가장 가까운 기존 예제를 읽습니다.

캡처: 폴더 레이아웃, 선택자 접두사, 명명, 독립형 대 NgModule 사용, 상태 관리, UI 라이브러리, DTO 및 모델 매핑, 오류 처리, 스타일링 접근 방식, 테스트 명명 및 테스트 러너. references/codebase-conventions.md를 사용하세요.

게이트 3: 감지된 버전으로 API 게이트

references/version-detection.md 및 아래 버전 매트릭스를 사용합니다. v17+에서는 명시적인 track과 함께 @if 및 @for를 선호하고, 프로젝트에서 이미 signals을 채택하는 경우 signal() 및 computed()를 사용합니다. 이전 버전의 경우 *ngIf, trackBy가 있는 *ngFor 및 RxJS 상태를 유지합니다. Zone 기반 프로젝트는 zone.js를 유지합니다. provideZonelessChangeDetection()은 zoneless가 지원되는 경우에만 추가하고, v21+에서는 provideZoneChangeDetection()를 사용하지 않으며, v22+에서는 명시적으로 standalone: true 또는 changeDetection: OnPush를 설정하지 않습니다.

게이트 4: 변경 설계

편집하기 전에 내부적으로 대상 파일, 구성 요소 책임, 상태 및 HTTP 액세스를 소유하는 서비스, 주입 스타일, 제공자 범위, 불변 데이터 형태, 인터셉터 순서, 구성 키, 접근성 의미론 및 작성할 단위 테스트를 명시합니다. references/change-detection-model.md, references/di-and-services.md, references/state-http-interceptors.md 및 references/official-docs.md를 참조하세요.

게이트 5: 구현

가장 작은 완전한 변경을 적용합니다:

  • 구성 요소를 얇게 유지: signals 또는 observables를 바인딩하고, 이벤트를 서비스에 위임하여 처리하며, 의미론적 템플릿으로 렌더링합니다.
  • any 없이 엄격한 TypeScript를 유지하고, 경계에서 unknown 값을 좁힙니다.
  • 최신 코드에서는 inject()를 사용하고 레거시 코드에서는 생성자 주입을 사용합니다. providedIn: 'root'로 서비스를 제공합니다.
  • async pipe 또는 toSignal()을 선호합니다. 구독이 불가피한 경우 takeUntilDestroyed() 또는 DestroyRef를 사용합니다.
  • switchMap, mergeMap, concatMap 또는 exhaustMap으로 중첩된 구독을 평탄화합니다.
  • 불변 업데이트, 명시적인 track 또는 trackBy와 함께 OnPush를 사용하고 무거운 템플릿 메서드는 사용하지 않습니다.
  • Angular 살균화를 유지합니다. 우회를 고려하기 전에 HTML, URL 또는 스타일 값의 유효성을 검사합니다.
  • 프로젝트의 오류 처리 및 DTO 매핑을 재사용하고, 명시적인 필요 없이 새 라이브러리를 추가하지 않습니다.

게이트 6: Jest 단위 테스트 작성

references/testing-jest.md를 따릅니다:

  • Jest, jest-preset-angular, TestBed 및 프로젝트의 기존 jest.config 및 setup-jest.ts를 사용합니다. 누락된 경우에만 생성하고 러너 선택을 확인한 후에 생성합니다.
  • 변경된 동작에 대해 성공, 검증 및 오류 경로를 격리된 단위 테스트로 다룹니다.
  • TestBed imports로 독립형 구성 요소, 모의 HttpClient 또는 모의 협력자로 서비스, 직접 파이프, 명시적 어설션이 있는 signals를 테스트합니다.
  • v20.2+의 zoneless 애플리케이션의 경우 TestBed 제공자에 provideZonelessChangeDetection()을 추가합니다. v21+의 경우 기본값에 의존합니다.
  • 모듈에는 jest.mock을 사용하고 집중 협력자에는 jest.spyOn을 사용합니다. observable 결과를 어설션하고 경계 상호 작용을 확인합니다.
  • Jest 임계값을 통해 최소 80%의 커버리지를 적용하고 게이트를 통과하기 위해 절대 낮추지 않습니다.
  • Karma 또는 Vitest가 이미 구성된 경우 Jest로 전환하기 전에 질문하고 필요한 정확한 구성을 제시합니다.

게이트 7: 검증

프로젝트 자체 명령을 실행하고 결과와 함께 기록합니다:

npx jest --coverage

프로젝트가 npm test -- --coverage와 같은 구성된 스크립트를 제공하는 경우 해당 명령을 대신 실행하고 정확한 호출을 기록합니다. 커버리지 요약을 열고 변경된 코드에 대해 최소 80%인지 확인합니다. 커버리지가 80% 미만이면 게이트를 낮추는 대신 단위 테스트를 추가하거나 조정합니다. 구성된 유형 검사 또는 빌드를 사용할 수 있는 경우 실행하고 종료 상태를 기록합니다.

게이트 8: 아티팩트 작성

references/report-template.md를 사용하여 ANGULAR-EXPERT-IMPL.md를 작성합니다. ID를 안정적으로 유지: 변경 사항에는 CHG-001, 테스트에는 T-001, 구성 추가에는 CFG-NNN, 증거에는 EV-NNN을 사용합니다. 내용이 없는 섹션에는 변경 사항 없음.을 사용하고 섹션을 비워 두지 않습니다.

게이트 9: 아티팩트 검증

python3 scripts/validate_report.py ANGULAR-EXPERT-IMPL.md

사용자가 정책을 명시적으로 변경하는 경우에만 --strict 또는 --min-coverage N을 사용합니다. 검증기를 실행할 수 없으면 수동으로 references/validation-checklist.md를 적용하고 검증기를 사용할 수 없었다고 명시합니다.

게이트 10: 인계

정확히 세 개의 제목으로 답변하며, 순서는 다음과 같습니다: ## 간략 분석, ## 깔끔하고 완전한 코드, ## 구성. 구성 섹션 후에 실제로 실행된 검증 명령, 측정된 커버리지 및 남은 위험을 나열합니다. 승인 판정을 추가하지 않습니다.

아티팩트 계약

보고서 템플릿과 형태가 바이트 단위로 동일한 필수 마커:

<!-- angular-expert:artifact type=implementation version=1 -->
<!-- angular-expert:section id=analysis -->
<!-- angular-expert:section id=stack -->
<!-- angular-expert:section id=design -->
<!-- angular-expert:section id=implementation -->
<!-- angular-expert:section id=tests -->
<!-- angular-expert:section id=validation -->
<!-- angular-expert:section id=configurations -->
<!-- angular-expert:section id=evidence -->
<!-- angular-expert:section id=assumptions -->
<!-- angular-expert:section id=traceability -->
<!-- angular-expert:stack angular=20.3.0 typescript=5.8.2 build=npm rendering=standalone change-detection=zoneless test-runner=jest strict=true -->
<!-- angular-expert:coverage value=88 gate=80 tool=jest -->
<!-- angular-expert:change id=CHG-001 status=implemented -->
<!-- angular-expert:test id=T-001 framework=jest testbed=true context=unit -->
<!-- angular-expert:evidence id=EV-001 status=passed -->
<!-- angular-expert:config id=CFG-001 file=angular.json -->

안정적인 ID 패밀리: 변경 사항은 CHG-NNN, 테스트는 T-NNN, 구성 추가는 CFG-NNN, 검증 증거는 EV-NNN입니다. 모든 변경 사항은 추적 가능성 테이블에서 하나 이상의 테스트와 하나의 증거 행에 연결되어야 합니다.

버전 매트릭스

감지된 Angular렌더링 기준제어 흐름 및 상태변경 감지 지침
v2-v16 (지원 안 함)NgModule 시대 패턴*ngIf, trackBy가 있는 *ngFor 및 RxJS 사용; 내장 제어 흐름 사용 불가Zone 기반; 요청하지 않으면 업그레이드 제안 금지
v17-v19 (지원 안 함)독립형 사용 가능, v19에서 기본값v17에서 제어 흐름 도입, v18에서 안정화; signals 사용 가능; 프로젝트에서 이미 사용하는 경우에만 사용Zone 기반; 실험적 zoneless는 v18-v19에 존재하며 범위 외
v20.0-v20.1독립형 기본값Signals 및 제어 흐름 안정화Zoneless 실험적
v20.2+독립형 기본값Signals 및 제어 흐름 안정화provideZonelessChangeDetection()을 통한 Zoneless 안정화
v21+독립형 기본값Signals, 제어 흐름 및 toSignal() 기준Zoneless가 기본값; provideZoneChangeDetection() 사용 금지
v22+독립형 및 OnPush 암시적standalone: true 명시적 설정 금지changeDetection: OnPush 명시적 설정 금지

감지기 출력이 권위적입니다. Angular v2-v19는 더 이상 지원되지 않습니다. 마이그레이션을 제안하는 대신 해당 제한 사항을 기록합니다. 매트릭스와 감지된 버전에 대한 공식 가이드의 지원을 확인하지 않고 버전 게이트 API를 도입하지 마십시오.

증거 규칙

  • 테스트, 유형 검사, 빌드 및 커버리지에 대한 정확한 명령, 종료 상태 및 측정값을 기록합니다.
  • 결정을 설명할 때 변경된 파일을 path:line으로 참조합니다.
  • ID, 마커, 심각도, 프레임워크 이름 및 상태 값을 영어로 유지합니다.
  • 토큰, 자격 증명 및 개인 데이터는 [REDACTED]로 수정합니다.
  • 구성 보고는 키로만 유지합니다. 아티팩트에 원시 구성 값을 붙여넣지 않습니다.
  • CI 결과를 주장하지 않습니다.

…

[번역을 위해 잘림]

관련 스킬