| name | note-search |
| description | notes/ 디렉토리의 학습 노트를 검색합니다. 노트 검색, 개념 찾기, 관련 노트, 키워드 검색, 태그 검색 요청 시 사용.
|
| argument-hint | [검색어 또는 옵션] |
노트 검색
note-writer로 생성된 학습 노트를 효과적으로 검색합니다.
검색 전략
1단계: 빠른 매칭 (frontmatter)
grep -rl "keywords:.*검색어" notes/ --include="SKILL.md"
grep -l "name: .*검색어" notes/ --include="SKILL.md"
grep -l "description:.*검색어" notes/ --include="SKILL.md"
2단계: 관련성 확장
grep -rl "related:.*검색어" notes/ --include="SKILL.md"
grep -rl "aliases:.*검색어" notes/ --include="SKILL.md"
grep -rl "\[\[.*검색어.*\]\]" notes/ --include="SKILL.md"
3단계: 본문 검색
grep -rl "검색어" notes/ --include="SKILL.md"
검색 옵션
| 옵션 | 사용법 | 설명 |
|---|
| 기본 | /note-search 검색어 | 전체 필드 검색 |
| 카테고리 | /note-search --category react 검색어 | 특정 카테고리만 |
| 태그 | /note-search --tag type/concept | 태그 기반 검색 |
| 관련 | /note-search --related 노트명 | 연결된 노트 탐색 |
출력 형식
기본 출력 (요약)
## 검색 결과: "검색어"
### 1. 노트명 (notes/category/topic/)
- **키워드**: keyword1, keyword2
- **요약**: 핵심 내용 1-2문장
### 2. 다른노트 (notes/category/topic2/)
- **키워드**: keyword3
- **요약**: 핵심 내용 1-2문장
---
총 N개 노트 발견. 상세 내용은 해당 노트 참조.
상세 출력 요청 시
### 노트명 (notes/category/topic/)
- **키워드**: keyword1, keyword2
> [!summary]
> 요약 내용 전체
**핵심 내용 미리보기:**
- 포인트 1 요약
- 포인트 2 요약
[전체 내용 보기](notes/category/topic/SKILL.md)
검색 워크플로우
[검색어 입력]
│
├─ 1. keywords 필드 검색 ──→ 정확한 매칭
│
├─ 2. name/description 검색 ──→ 제목/설명 매칭
│
├─ 3. related/aliases 검색 ──→ 관련 개념 매칭
│
├─ 4. 본문 검색 ──→ 전체 텍스트 매칭
│
└─ 5. 결과 병합 및 중복 제거
│
└─ 관련성 순 정렬하여 출력
관련 노트 탐색
특정 노트의 연결 관계를 탐색:
grep -A5 "related:" notes/category/topic/SKILL.md
grep -rl "\[\[topic\]\]" notes/ --include="SKILL.md"
카테고리 목록 조회
ls notes/
ls notes/category/
실행 예시
/note-search useState
→ keywords에 "useState" 포함된 노트 우선
→ related에 "useState" 있는 노트 추가
→ 본문에 "useState" 언급된 노트 추가
→ 결과 출력
결과 없을 때
"검색어"에 대한 노트를 찾을 수 없습니다.
추천:
- 다른 키워드로 검색해 보세요
- /note-writer로 새 노트를 생성할 수 있습니다
- 카테고리 목록: ls notes/
