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를 사용하세요.

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

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

검색하는 경우 (예시):

검색하지 않는 경우 (이 경우에만 스킵):

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

예시:

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

검색 모드(~/.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는 맥락이 있을 때만 전달합니다.

검색 결과의 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 중 하나는 반드시 실행합니다.

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

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 필드로 검색 방법을 설정할 수 있습니다:

{
  "searchMethod": "auto"
}

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

설정 변경:

# CLI로 설정
aitk config set searchMethod cli

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