AI
AI와 글쟁이의 동행: 코드 주면 API 레퍼런스 써드려요
두줄요약
AI를 활용해 사내 컨텍스트를 반영한 API 주석 생성과 문서 배포 프로토타입을 만들었습니다.다만 정확성 한계가 있어 사람 검토를 전제로 보조 도구로 활용해야 했습니다.
핵심 내용
- 기술 문서 부족 문제를 AI와 엔지니어링으로 보완하려는 접근
- 사내 스타일과 컨텍스트를 반영한 API 주석 생성 및 웹 문서 배포 프로토타입
- VS Code 익스텐션에서 MCP 기반 구조로 전환해 범용성과 기능 분리를 확보
- AI 평가 결과와 한계를 바탕으로 사람 검토의 필요성 재확인
선택 이유
- 코딩 어시스턴트의 일반적 설명 한계를 보완하기 위한 사내 문서 특화 목표
- 긴 프롬프트를 단계 분리로 개선하면서 정확도와 처리 시간 간 균형 추구
장단점
- 장점: 사내 컨텍스트 반영, 주석 생성과 배포 자동화, IDE 의존성 완화
- 단점: 완전한 정확성 보장 불가, 잘못된 정보 발생 가능, 최종 검토 필요
적용해볼 점
- 문서 생성 작업에서 사람 검토를 전제로 AI를 보조 도구로 활용
- UI 중심 구현보다 기능 중심 MCP 구조로 확장성 검토