smorky850612/Aurakit / skills/aura
aura
VerifiedAll-in-one fullstack dev engine. /aura: 46 modes (build/fix/clean/deploy/review/spec/lore/ax/experiment/payment/debug/qa/orchestrate/escalate+), 6-layer security with 32 hooks, tiered models (ZERO/ECO/PRO/MAX), 8 languages, 16 specialized agents, SPEC/EARS/TRUST5/XLOOP/RALF/Autopus absorbed. ~55% token savings.
resources/review-pipeline.md
View on GitHub# AuraKit — REVIEW Pipeline (상세)
> 이 파일은 REVIEW 모드에서만 로딩된다. (Progressive Disclosure)
---
## 원칙 (Mandatory — 위반 시 재실행)
- **객관적 측정**: 점수 기반 리포트 (A~F) [필수]
- **실행 가능한 피드백**: 파일:라인 + 수정 제안 [필수]
- **Tiered Model**: Worker-A/B → sonnet/opus(MAX), Worker-C/D → haiku/sonnet(MAX) (비용 ~40% 절감, ECO 기준) [필수]
- **병렬 실행**: Worker 에이전트 4개 동시 실행 (격리 서브에이전트) [필수]
---
## Step 1: 변경 파일 감지
```bash
# 커밋되지 않은 변경 파일
git diff --name-only
# 마지막 커밋의 변경 파일
git diff --name-only HEAD~1 HEAD
# 특정 브랜치와 비교
git diff --name-only main...feature/my-branch
```
사용자가 특정 파일/디렉토리를 지정한 경우 해당 범위만 리뷰.
지정하지 않은 경우: `git diff --name-only` 결과 사용.
---
## Step 2: Worker 에이전트 4개 병렬 실행 [Tiered Model, 필수]
```
Worker-A: 코드 리뷰 Agent(model="sonnet") — ECO/PRO 기준
Worker-B: 보안 L3 스캔 Agent(model="sonnet") — ECO/PRO 기준
Worker-C: 테스트 실행 Agent(model="haiku") ← ECO/PRO 필수 (Sonnet 실행 금지)
Worker-D: Gap 분석 Agent(model="haiku") ← ECO/PRO 필수 (Sonnet 실행 금지)
→ 4개 동시 실행 [필수], 결과 취합
→ 성공 시 "Pass" 한 줄 반환 (Fail-Only Output)
```
### Worker-A: 코드 리뷰 체크리스트
```
코드 품질:
□ 에러 핸들링 — try-catch, error boundary
□ 입력 검증 — 모든 사용자 입력 검증 여부
□ 타입 안정성 — any 타입, 타입 캐스팅 남용
□ 네이밍 — 의미있는 이름, 일관성
□ 중복 코드 — DRY 원칙
□ 컴포넌트 크기 — 250줄 이내
□ 단일 책임 — 함수/컴포넌트가 한 가지 일만
□ loading/error 상태 — UI 처리
□ 접근성 — alt, label, ARIA
성능:
□ 불필요한 리렌더링 — React.memo, useMemo, useCallback
□ N+1 쿼리 패턴 — DB 쿼리 최적화 필요 여부
□ 번들 사이즈 — 불필요한 import
```
### Worker-B: 보안 L3 스캔 체크리스트
```
인젝션:
□ SQL Injection — parameterized query 사용 여부
□ XSS — dangerouslySetInnerHTML, innerHTML 사용 여부
□ Command Injection — exec(), spawn() 입력 검증
□ Path Traversal — 파일 경로 검증
인증/인가:
□ 인증 미들웨어 — 보호 라우트 커버리지
□ 토큰 저장 — localStorage 저장 여부
□ CSRF 보호 — 상태 변경 요청
□ 권한 검사 — 리소스 소유권 확인
시크릿:
□ 하드코딩된 시크릿 — API_KEY, SECRET 패턴
□ 클라이언트 노출 — NEXT_PUBLIC_ 시크릿
□ 로그 노출 — console.log(sensitiveData)
네트워크:
□ CORS 설정 — 와일드카드 *
□ Rate Limiting — 구현 여부
□ 보안 헤더 — CSP, X-Frame-Options
```
### Worker-C: 테스트 실행
```bash
# Node.js
npm test
# 또는
npx vitest run
npx jest --ci
# Python
pytest --tb=short
# 결과:
# N tests passed, N failed, N skipped
# coverage: N%
```
---
## Step 5: bloat-check.js 실행
```bash
# 250줄 초과 파일 감지
find src -name "*.ts" -o -name "*.tsx" -o -name "*.py" | \
xargs wc -l | sort -rn | awk '$1 > 250 {print $1, $2}'
```
---
## Step 6: 통합 리포트 생성
### 리포트 포맷
```markdown
# AuraKit Review Report
생성 시각: 2025-01-15T17:00:00Z
리뷰 범위: git diff HEAD~1 HEAD (4 files)
---
## 🔴 보안 이슈
### VULN-001 [HIGH] SQL Injection 취약점
- 위치: `src/app/api/search/route.ts:34`
- 심각도: HIGH
- 설명: 사용자 입력이 SQL 쿼리에 직접 삽입됨
- 현재 코드:
```typescript
const results = await db.query(`SELECT * FROM products WHERE name = '${query}'`)
```
- 수정 제안:
```typescript
const results = await db.query('SELECT * FROM products WHERE name = $1', [query])
```
### VULN-002 [MEDIUM] 인증 토큰 localStorage 저장
- 위치: `src/lib/auth.ts:78`
- 심각도: MEDIUM
- 설명: JWT 토큰을 localStorage에 저장하여 XSS 취약점 노출
- 수정 제안: httpOnly cookie 사용
---
## 🟡 코드 품질 이슈
### WARN-001 에러 핸들링 누락
- 위치: `src/components/UserList.tsx:45`
- 설명: async 함수에 try-catch 없음
- 수정 제안: ErrorBoundary로 감싸거나 try-catch 추가
### WARN-002 컴포넌트 크기 초과
- 위치: `src/components/Dashboard.tsx` (342줄)
- 설명: 250줄 초과
- 수정 제안: DashboardStats, DashboardChart로 분할
### WARN-003 미사용 import
- 위치: `src/lib/utils.ts:3`
- 설명: `import { debounce } from 'lodash'` — 미사용
- 수정 제안: 해당 import 제거
---
## 🟢 테스트 결과
총 24개 테스트:
- ✅ 22 Passed
- ❌ 2 Failed:
- `UserService > createUser > should validate email format` (src/services/user.service.test.ts:45)
- `AuthController > login > should reject invalid password` (src/controllers/auth.test.ts:89)
커버리지: 67.3% (목표: 80%)
---
## 📏 블로트 경고
| 파일 | 줄 수 | 권장 |
|------|-------|------|
| src/components/Dashboard.tsx | 342 | 분할 |
| src/app/api/users/route.ts | 289 | 분할 |
---
## 📊 전체 점수
| 항목 | 점수 |
|------|------|
| 보안 | D (HIGH 취약점 1개) |
| 코드 품질 | C (이슈 3개) |
| 테스트 | C (2 Failed, 커버리지 67%) |
| 블로트 | B (2개 파일 초과) |
**전체: C (수정 권장)**
---
## 🔧 권장 액션
우선순위 순:
1. `VULN-001` 즉시 수정 필요 — `/aura VULN-001 수정해줘`
2. `VULN-002` 수정 필요 — `/aura 토큰 저장 방식 수정해줘`
3. 실패한 테스트 수정 — `/aura 실패한 테스트 수정해줘`
4. Dashboard.tsx 분할 — `/aura Dashboard 컴포넌트 분할해줘`
```
---
## 점수 산정 기준
| 등급 | 보안 | 품질 | 테스트 |
|------|------|------|--------|
| A | 이슈 없음 | 이슈 없음 | 100% Pass + 80%+ 커버리지 |
| B | LOW 이슈만 | 1~2개 | 98%+ Pass |
| C | MEDIUM 이슈 | 3~5개 | 90%+ Pass |
| D | HIGH 이슈 | 6~10개 | 80%+ Pass |
| F | CRITICAL 이슈 | 10개 초과 | 80% 미만 |
---
## Step 7: Gap Check → ITERATE 자동 체인 [P1 신규]
리뷰 완료 후 자동 Gap Check 실행:
```
Gap Worker: Agent(model="haiku") ← ECO/PRO 필수 (Sonnet 직접 실행 금지)
→ .aura/design-system.md vs 현재 구현 비교
→ Match Rate 계산
Match Rate ≥ 90% → 리뷰 완료, 커밋 권고
→ "✅ REVIEW 완료 — Match Rate N%. 커밋 후 /aura deploy: 권장"
Match Rate < 90% → 자동 ITERATE 모드 전환
→ "⚠️ Match Rate N% — ITERATE 모드로 자동 전환합니다"
→ resources/iterate-pipeline.md 로딩 → 최대 5회 자동 수정
```
**자동 체인 흐름:**
```
REVIEW → Gap Check → [Match Rate ≥90%] → 완료 리포트
→ [Match Rate <90%] → ITERATE (최대 5회) → 완료 리포트
```
이 체인은 자동으로 실행된다. 사용자 확인 없이 진행.
ITERATE 비활성화: `/aura review no-iterate:` 사용.
---
## Step 8: /simplify 자동 연결 [P2 신규]
ITERATE 완료(Match Rate ≥ 90%) 또는 리뷰 등급 A/B 달성 시:
```
Match Rate ≥ 90% AND 코드 품질 A/B → /simplify 권고
→ "✅ 코드 품질 양호 — /simplify로 최종 정리 권장"
→ 사용자 확인 후 실행 (자동 실행 아님)
/simplify 실행 내용:
- 미사용 import/변수 제거
- 중복 로직 통합
- 네이밍 일관성 검사
- 250줄 초과 파일 분할
- 기능 변경 없이 구조만 개선
```
**흐름:**
```
REVIEW → Gap Check → ITERATE (필요 시) → ≥90% 달성
→ /simplify 권고 → 사용자 확인 → 정리 실행
→ 최종 커밋 → 완료 리포트
```
`/simplify` 비활성화: `/aura review no-simplify:` 사용.
---
## 완료 리포트 포맷
```
✅ AuraKit REVIEW 완료
범위: [N]개 파일
보안: [A/B/C/D/F] | 품질: [A/B/C/D/F] | 테스트: [N/N Pass]
Match Rate: [N]% → [자동 ITERATE 결과 있으면 표시]
Simplify: [실행됨/건너뜀]
다음: [권장 액션]
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |