---
name: skill-suggest
description: "새 작업/주제 변경 시 팀 스킬을 자동 검색합니다."
---

# Skill Suggest (자동 트리거 + 수동 검색)

> **IMPORTANT**: 이 스킬은 두 가지 경우에 적용됩니다:
> 1. 새 작업을 시작하거나 주제가 바뀔 때 (자동 트리거)
> 2. 사용자가 직접 스킬/플러그인 검색을 요청했을 때 ("스킬 검색해줘", "유튜브 관련 스킬 찾아줘" 등)

## 검색 방법 결정 (모든 검색에 필수)

스킬 검색 시 **반드시** `~/.config/aitk/config.json`의 `searchMethod` 설정을 확인하고, 설정에 맞는 방법으로 검색합니다:

| searchMethod | 검색 방법 |
|---|---|
| `cli` | `Bash("aitk search '키워드'")` — **MCP 도구 사용 금지** (기본값) |
| `mcp` | `mcp_gpters-ai-toolkit_semantic_search(...)` |
| `auto` | MCP 우선, 연결 불가 시 aitk CLI fallback |

> **주의**: `searchMethod`가 `cli`인데 MCP 도구(`semantic_search`)로 검색하면 안 됩니다. 사용자가 의도적으로 CLI 모드를 선택한 것이므로 반드시 `aitk` CLI를 사용하세요.

## 검색 여부 판단 (자동 트리거 시에만 확인)

사용자가 직접 검색을 요청한 경우에는 이 판단을 건너뛰고 바로 검색합니다.
자동 트리거 시에만 아래 기준으로 판단합니다:

**기본 원칙: 새 주제면 무조건 검색합니다.** 아래 "검색하지 않는 경우"에 해당하지 않으면 전부 검색 대상입니다.

**검색하는 경우 (예시):**
- 새로운 작업/기능 구현을 시작할 때
- 대화 주제가 명확히 바뀔 때
- 새로운 기술/프레임워크/도구에 대한 질문 (예: "remotion 어떻게 써", "Redis 설정 방법")
- 사용법, 가이드, 튜토리얼 요청
- 일반 프로그래밍 질문이라도 팀에 관련 스킬이 있을 수 있으므로 검색

**검색하지 않는 경우 (이 경우에만 스킵):**
- 바로 직전 응답에 대한 후속 질문, 확인, 수정 요청
- "계속해줘", "푸시해줘", "커밋해줘", "다시 해봐" 같은 지시형 메시지
- 이미 이번 세션에서 같은 주제로 검색한 적이 있는 경우

## 워크플로우

### 1단계: 핵심 키워드 + 작업 맥락 추출

사용자 프롬프트에서 두 가지를 추출합니다:

1. **핵심 키워드 (2~4단어)**: 작업 의도를 나타내는 핵심 키워드
2. **작업 맥락 (선택)**: 현재 대화에서 파악된 기술 스택, 진행 상황 등 배경 정보

예시:
- "React로 대시보드 만들어줘" → 키워드: `"React 대시보드"`, 맥락: 없음
- "코드 리뷰 해줘" → 키워드: `"코드 리뷰"`, 맥락: 없음
- "슬랙 봇에서 멘션 수집하는 기능 추가해줘" (airtable 연동 진행 중) → 키워드: `"슬랙 봇 멘션 수집"`, 맥락: `"airtable 연동, 슬랙 API"`

### 2단계: 스킬 검색

검색 모드(`~/.config/aitk/config.json`의 `searchMethod`)에 따라 다르게 검색합니다:

**MCP 모드 (`mcp` 또는 `auto`):**
```
mcp_gpters-ai-toolkit_semantic_search(query="추출된 키워드", userContext="작업 맥락", limit=3, _source="skill-suggest")
```

**CLI 모드 (`cli`):**
```
Bash("aitk search '추출된 키워드' --limit 3 --context '작업 맥락'")
```

> `auto` 모드에서 MCP 연결 불가 시 CLI로 fallback합니다.
> `userContext`/`--context`는 맥락이 있을 때만 전달합니다.

### 3단계: 결과 판단 + 로드

검색 결과의 `relevanceScore`를 확인합니다:

**A. 0.40 이상 스킬이 있으면 → 로드:**

MCP 모드:
```
mcp_gpters-ai-toolkit_get_plugin_content(pluginId="스킬ID")
```

CLI 모드:
```
Bash("aitk get '스킬ID'")
```

**B. 전부 0.40 미만이거나 관련 없으면 → 스킵 사유 보고:**

MCP 모드:
```
mcp_gpters-ai-toolkit_report_search_skip(query="검색어", resultIds=["id1","id2"], reason="스킵 사유 한 줄")
```

CLI 모드:
```
Bash("aitk report-skip --query '검색어' --reason '스킵 사유 한 줄' --result-ids 'id1,id2'")
```

> 검색 후 아무 행동 없이 넘어가지 마세요. A 또는 B 중 하나는 반드시 실행합니다.

### 4단계: 적용 결과 보고

스킬을 로드해서 작업에 적용한 후, 결과를 보고합니다:

MCP 모드:
```
mcp_gpters-ai-toolkit_report_skill_outcome(skillId="스킬ID", applied=true/false, summary="결과 한 줄")
```

CLI 모드:
```
Bash("aitk report-outcome --skill-id '스킬ID' --applied true --summary '결과 한 줄'")
```

## 검색 모드 설정

`~/.config/aitk/config.json`의 `searchMethod` 필드로 검색 방법을 설정할 수 있습니다:

```json
{
  "searchMethod": "auto"
}
```

| 값 | 동작 |
|----|------|
| `cli` | aitk CLI만 사용 (기본값) |
| `mcp` | MCP만 사용. 연결 불가 시 검색 스킵 |
| `auto` | MCP 우선, 연결 불가 시 aitk CLI fallback |

설정 변경:
```bash
# CLI로 설정
aitk config set searchMethod cli

# 또는 직접 편집
vi ~/.config/aitk/config.json
```

## 주의사항

- 스킬 내용이 사용자 요청과 충돌하면 사용자 요청을 우선합니다
- MCP 서버 연결 실패 시 스킬 검색을 건너뛰고 작업을 진행합니다
- 결과가 없으면 검색 없이 바로 진행합니다