AI 어시스턴트와 함께 사용하기

codeknit은 AI 코딩 어시스턴트가 효과적으로 사용할 수 있도록 준비된 skill과 함께 제공됩니다. 이러한 skill을 통해 어시스턴트는 수동 프롬프트 없이 코드 구조 추출, 중복 감지 및 구조 분석을 수행할 수 있습니다.

Skill 개요

codeknit은 두 가지 skill을 제공합니다:

codeknit-parse: 어시스턴트가 코드 구조(함수, 클래스, 메서드, 변수) 및 관계(호출, 상속, 포함)를 .skt 파일로 추출하는 방법을 가르칩니다.
codeknit-fingerprint: 어시스턴트가 퍼지 해싱을 사용하여 중복 및 근사 중복 코드를 감지하는 방법을 가르칩니다.

각 skill에는 어시스턴트가 사용법, 플래그, 출력 형식 및 워크플로우를 이해하는 데 필요한 문서가 포함되어 있습니다.

설치

skill 디렉터리를 어시스턴트의 skills 폴더로 복사합니다.

Kiro의 경우:

cp -r skills/codeknit-parse ~/.kiro/skills/codeknit-parse
cp -r skills/codeknit-fingerprint ~/.kiro/skills/codeknit-fingerprint

Claude Code의 경우:

cp -r skills/codeknit-parse ~/.claude/skills/codeknit-parse
cp -r skills/codeknit-fingerprint ~/.claude/skills/codeknit-fingerprint

설치 후, 어시스턴트는 자동으로 codeknit 명령어를 호출하고 적절한 플래그를 선택하며 .skt 출력을 해석하는 방법을 알게 됩니다.

각 skill이 가르치는 내용

codeknit-parse

codeknit-parse skill은 어시스턴트에게 다음을 가르칩니다:

다양한 시나리오에 적합한 플래그로 codeknit parse 실행하기
적절한 출력 모드 선택:
- 대부분의 프로젝트에 directory-flat(기본값)
- 단일 파일 또는 작은 입력에 inline
- 소스 구조를 미러링하기 위해 directory-tree
.skt 출력 파일 읽기 및 해석, [symbols], [edges], 선택적 [dict] 섹션 포함
구조적 데이터를 리팩터링, 의존성 매핑 및 코드 리뷰에 활용하기
codeknit graph analyze를 실행하여 더 깊은 코드 품질 인사이트 얻기(순환 의존성, 허브 심볼, god class 등)

codeknit-fingerprint

codeknit-fingerprint skill은 어시스턴트에게 다음을 가르칩니다:

중복 감지, DRY 감사 및 리팩터 식별을 위해 codeknit fingerprint 사용하기
적절한 유사도 범위 선택(--min-similarity, --max-similarity)
출력에서 [duplicates] 섹션을 읽어 근사 중복 코드 식별하기
fingerprints가 의미적 의도가 아닌 구조적 형태를 측정한다는 점 이해하기
필요한 경우 Ollama 임베딩과 --rerank을 사용하여 거짓 양성 줄이기

워크플로 예시

구조 분석

어시스턴트에게 코드베이스 구조 분석 요청
어시스턴트가 codeknit parse ./src를 실행하고 결과 .skt 파일 읽기
구조적 질문에 답변: 의존성, 호출 체인, 데드 코드
더 깊은 인사이트를 위해 codeknit graph analyze ./src 실행 및 보고서 해석

[symbols]
## src/service.go
S1 type/struct L5-L8 AuthService {}
S2 callable/method L10-L15 Authenticate(token: string) {receiver=*AuthService}

[edges]
S1 --contains--> S2

중복 감지

어시스턴트에게 중복 코드 찾기 요청
어시스턴트가 codeknit fingerprint ./src 실행
출력에서 [duplicates] 섹션 읽기
플래그가 지정된 쌍 조사 및 통합 제안

[duplicates]
S1, S2: 87% 유사도
S3, S4: 76% 유사도

팁

구조적 질문에 대해서는 원본 소스가 아닌 .skt 파일 읽기 — .skt 파일은 추출된 구조를 간결하고 신뢰할 수 있는 형식으로 포함
순환 의존성, 허브 심볼, 깊은 상속 체인과 같은 코드 품질 문제를 발견하기 위해 codeknit graph analyze 사용
대규모 리팩터링 전에 codeknit fingerprint를 실행하여 통합해야 할 복사-붙여넣기 코드 식별
.skt 형식은 토큰 효율성을 위해 설계되어 LLM 컨텍스트 윈도우에 이상적
대규모 코드베이스를 처리할 때 토큰 사용량을 더욱 줄이기 위해 --minify 사용