types-constants-audit-skill은(는) 무엇을 하나요?
웹 저장소에서 TypeScript 타입 및 상수 구성을 감사하기 위한 Codex 스킬입니다.
개요
이 스킬은 웹 프로젝트의 TypeScript 타입과 상수 정의가 일관된 구조를 따르는지 자동으로 감사합니다. 타입과 상수를 분리하여 정의하는 모범 사례와의 불일치, 중복 선언, 그리고 부적절한 위치에 선언된 상수나 타입을 찾아줍니다.
사용법
Codex 에이전트 내에서 다음 명령어를 사용하여 스킬을 실행할 수 있습니다:
codex run talibabtou/types-constants-audit-skill
또는 프로젝트 루트에서 직접 스킬을 호출:
audit-types-constants
기능
- 타입 파일(
types.ts,types/)과 상수 파일(constants.ts,constants/) 스캔 - 네이밍 규칙 위반 감지 (예: 타입에 PascalCase 사용, 상수에 UPPER_SNAKE_CASE 권장 등)
- 불필요한 전역 타입/상수 선언 식별
- 중복 또는 충돌하는 타입/상수 정의 발견
- 파일 분리 규칙 위반 사항 보고
규칙 예시
| 규칙 | 설명 | 위반 예시 |
|---|---|---|
type-naming-convention | 타입은 PascalCase 사용 | userAge → UserAge |
constant-naming-convention | 상수는 UPPER_SNAKE_CASE 사용 | apiKey → API_KEY |
no-duplicate-types | 동일 이름의 타입 중복 금지 | 두 파일에 User 타입 정의 |
no-magic-constants | 매직 넘버/문자열은 상수로 추출 | if (status === 3) → if (status === STATUS_ACTIVE) |
참고
이 스킬은 ESLint, Prettier 등 기존 도구와 함께 사용할 수 있으며, CI/CD 파이프라인에 통합하여 코드 리뷰 전 자동 검증이 가능합니다. 사용자 정의 규칙은 .codex/config 파일에서 추가할 수 있습니다.
제작자: Talibabtou