kfind문서

에이전트 · skill

skill 설치

저장소의 skill 문서는 검색 명령, 결과 해석과 fallback을 하나의 반복 가능한 계약으로 묶습니다.

설치 위치

skills/kfind-search/SKILL.md와 함께 참조하는 script를 에이전트가 읽을 수 있는 skill directory에 설치합니다. 원본의 상대 경로 관계를 보존합니다.

프로젝트 전용 설치에서는 저장소 revision을 고정합니다. 전역 설치에서는 여러 프로젝트가 같은 binary version을 요구하는지 먼저 확인합니다.

호출 방식

Skill은 표제어, 예상 품사, 검색 path와 결과 형식을 입력으로 받습니다. 자동화에서는 JSON Lines를 기본으로 사용하고 사람이 확인할 때만 text나 TUI로 전환합니다.

검색 실패와 no-match를 분리하고, component resource 오류가 발생하면 any로 조용히 완화하지 않습니다.

갱신

CLI option, JSON schema 또는 rule provenance 계약이 바뀌면 같은 release의 skill을 함께 갱신합니다. Skill 본문은 현재 명령만 설명하고 revision별 변경 이력은 release와 결정 기록에 둡니다.