@kood/claude-code 0.5.9 → 0.6.0

package/templates/.claude/skills/crawler/references/selector-strategies.md

@@ -0,0 +1,140 @@
+# Selector 전략
+
+> Playwright Selector 우선순위 및 패턴
+
+---
+
+<priority>
+
+## 우선순위
+
+| 순위 | 유형 | 예시 | 안정성 |
+|------|------|------|--------|
+| 1 | aria-ref | `aria-ref=e14` | 세션 한정 |
+| 2 | data-testid | `[data-testid="submit"]` | 매우 높음 |
+| 3 | Role + Name | `getByRole('button', { name: 'Save' })` | 높음 |
+| 4 | Text/Label | `getByText('Sign in')` | 중간 |
+| 5 | Semantic | `button[type="submit"]` | 중간 |
+| 6 | Class/ID | `.btn-primary` | 낮음 |
+
+</priority>
+
+---
+
+<extraction>
+
+## Selector 추출
+
+```javascript
+// aria-ref → Playwright selector
+const snapshot = await accessibilitySnapshot({ page });
+// => button "Save" [ref=e14]
+
+const selector = await getLocatorStringForElement(page.locator('aria-ref=e14'));
+// => "getByRole('button', { name: 'Save' })"
+```
+
+</extraction>
+
+---
+
+<patterns>
+
+## Locator 패턴
+
+### Role 기반 (권장)
+
+```javascript
+page.getByRole('button', { name: 'Submit' })
+page.getByRole('link', { name: 'Home' })
+page.getByRole('textbox', { name: 'Email' })
+page.getByRole('checkbox', { name: 'Remember' })
+```
+
+### 텍스트 기반
+
+```javascript
+page.getByText('Sign in')
+page.getByText(/sign in/i)  // 정규식
+page.getByLabel('Email')
+page.getByPlaceholder('Enter email')
+```
+
+### CSS Selector
+
+```javascript
+page.locator('[data-testid="submit"]')
+page.locator('input[name="email"]')
+page.locator('button:has-text("Save")')
+page.locator('li:nth-child(2)')
+```
+
+### 체이닝/필터
+
+```javascript
+page.locator('.card').locator('.price')
+page.locator('tr').filter({ hasText: 'John' }).locator('button')
+page.locator('.item').first()
+page.locator('.item').nth(2)
+```
+
+</patterns>
+
+---
+
+<crawling>
+
+## 크롤링용 패턴
+
+```javascript
+// 목록 추출
+const texts = await page.locator('.item').allTextContents();
+
+// 구조화 데이터
+const items = await page.$$eval('.card', cards =>
+  cards.map(c => ({
+    title: c.querySelector('h2')?.textContent?.trim(),
+    url: c.querySelector('a')?.href,
+  }))
+);
+
+// 속성 추출
+const links = await page.$$eval('a', els => els.map(el => el.href));
+```
+
+</crawling>
+
+---
+
+<wait>
+
+## 대기
+
+```javascript
+await page.waitForSelector('.loaded');
+await page.waitForSelector('.loading', { state: 'hidden' });
+await page.waitForLoadState('networkidle');
+```
+
+</wait>
+
+---
+
+<troubleshooting>
+
+## 문제 해결
+
+| 문제 | 해결 |
+|------|------|
+| 여러 요소 매칭 | `.first()`, `.nth(n)`, 더 구체적 selector |
+| 요소 없음 | `waitForSelector`, iframe/Shadow DOM 확인 |
+| 동적 클래스 | Role/Text 기반, data-testid 사용 |
+
+```javascript
+// 동적 클래스 해결
+// ❌ page.locator('.Button_a1b2c3')
+// ✅ page.getByRole('button', { name: 'Submit' })
+// ✅ page.locator('[data-testid="submit"]')
+```
+
+</troubleshooting>

package/templates/.claude/skills/execute/SKILL.md

@@ -51,6 +51,10 @@ user-invocable: true
 | **@architect** | sonnet/opus | 아키텍처 분석, 설계 검토 (READ-ONLY) | MEDIUM-HIGH |
 | **@analyst** | sonnet | 요구사항 분석, 기술 조사, 가정 검증 | MEDIUM |
 | **@document-writer** | haiku | 문서 작성 (README, API 문서) | LOW-MEDIUM |
+| **@deep-executor** | opus | 자율적 딥 워커, 복잡한 작업 스스로 완료 | HIGH |
+| **@researcher** | sonnet | 외부 문서/API 조사 | LOW-MEDIUM |
+| **@scientist** | sonnet | Python 데이터 분석, 통계 연구 | MEDIUM |
+| **@vision** | sonnet | 미디어 파일 분석 (이미지, PDF, 다이어그램) | LOW-MEDIUM |
 
 ---
 
@@ -449,6 +453,7 @@ Task({
 
 | 복잡도 | 조건 | 사용 Agent |
 |--------|------|-----------|
+| **극도로 복잡** | 전체 시스템 재설계, 완전 자율 | Task (deep-executor) 단일 위임 |
 | **매우 복잡** | 다중 시스템, 아키텍처 변경, 불확실성 높음 | Task (implementation-executor) 병렬 위임 |
 | **복잡/보통** | 명확한 범위, 3-10 파일 | 직접 처리 (Task Explore 활용) + 병렬 구현 |
 | **간단** | 1-2 파일, 명확한 변경 | 직접 처리 |