이번 소식
TanStack이 AI 코딩 에이전트용 안내를 관리하는 Intent 0.5를 공개했습니다. 여기서 스킬은 에이전트가 라이브러리를 사용할 때 참고하는 설명과 코드 예제입니다. 라이브러리 코드는 바뀌었는데 안내만 옛 방식으로 남는 문제를 찾도록 예제 검사와 변경 검토 흐름을 추가했습니다.
주요 변경
- 예제 코드 검사:
SKILL.md의 JavaScript·TypeScript 코드 블록과 JSX·TSX 예제를 라이브러리의 타입 정보와 대조합니다. 사라진 이름, 잘못된 옵션, 타입·문법 오류를 파일과 줄 번호로 알리고 폐기 예정 항목은 경고합니다. - 변경과 검토 연결: 소스가 바뀌면 영향을 받는 안내와 아직 대응하는 설명이 없는 변경을 보여줍니다. 안내를 수정했는지, 그대로 둬도 되는 이유가 무엇인지 검토한 소스·스킬 내용과 함께 기록합니다.
- 자동 검사와 수정 제안: GitHub 작업 흐름에서 예제 검증, 생성 파일 차이, 미완료 검토를 확인할 수 있습니다.
intent repair는 명확한 문서 머리말 수정을 적용하거나 검토용 패치를 제안합니다.
영향 대상과 활용
예를 들어 라이브러리의 함수 이름을 바꿨는데 스킬 예제가 이전 이름을 쓰고 있다면, 에이전트가 그 안내를 따르기 전에 검사로 발견할 수 있습니다. 주된 대상은 npm 패키지에 스킬을 함께 배포하는 라이브러리 관리자와 사내 AI 개발 안내를 유지하는 팀입니다.
눈여겨볼 부분은 안내 파일의 나이만 보는 대신, 실제로 바뀐 소스와 설명을 누가 검토했는지 연결한다는 점입니다. 이미 검토한 내용이 그대로라면 같은 판단을 반복해서 요구하지 않고, 내용이 새로 바뀌면 예전 판단을 그대로 승인으로 쓰지 않습니다.
사용 전 확인할 점
코드 검사는 TypeScript 5.0 이상이 필요합니다. TypeScript나 대상 라이브러리의 진입점을 찾지 못하면 타입 검사를 건너뛰었다고 알립니다. 예제를 직접 실행하는 검사는 아니므로 통과해도 실제 실행 결과나 설명 방식이 옳다고 보장하지 않습니다. 짧은 예제에 생략된 주변 선언·설정도 모두 오류로 처리하지는 않습니다.
코드 예제의 수정 제안은 검토가 필요하며 쓰기 모드가 자동 적용하지 않습니다. CI도 수정 사항을 대신 공개하거나 의미상의 검토를 완료 처리하지 않습니다. 이 기사에서는 실제 저장소에 도구를 설치하거나 예제를 실행하지 않았습니다.
이전 버전의 intent scaffold는 maintainer 흐름으로 바뀌었고 maintainer adopt는 제거됐습니다. 기존 스크립트는 maintainer setup 등 현재 명령을 확인해야 합니다.
공식 출처·발표 시점
0.5.0 릴리스 공개 시각: 2026년 9월 30일 13:08 KST. 공식 릴리스와 기능 발표를 대조했습니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.