AI 어시스턴트가 더 나은 Node.js 코드를 생성하도록 돕기 위해 정리한 개인 스킬 저장소와 그 안에 담긴 Fastify, Node.js, TypeScript, OAuth, 문서화 등의 실전 베스트 프랙티스를 소개합니다.
안녕하세요 여러분!
여러분과 공유하고 싶은 무언가를 작업해 왔습니다. 아시다시피 저는 이제 코딩의 대부분을 AI 어시스턴트에 의존하기 시작했지만, 생성되는 모든 것을 검토합니다.
저는 생성되는 엉성한 결과물 과 제가 해야 했던 수정의 양에 점점 답답함을 느끼게 되었습니다. Node.js, Fastify, TypeScript로 여러 해 동안 만들어 오면서 저는 많은 것을 배웠습니다. 잘 작동하는 패턴, 시간을 절약해 주는 도구, 그리고 전혀 예상하지 못한 순간에 발목을 잡는 함정들 말입니다. 저는 제 AI 어시스턴트가 제 기대치에 맞추거나, 적어도 그에 가깝게 따라오기를 원합니다.
저는 이 모든 것을 제 AI 어시스턴트가 활용해 제가 더 빠르게 작업할 수 있도록 하나의 컬렉션으로 정리하기로 했습니다. 여기 제가 만든 skills 저장소가 있습니다. npx skills add mcollina/skills 만으로 바로 사용을 시작할 수 있습니다. 이 저장소는 제 선호 사항과 베스트 프랙티스를 담고 있어서 매번 같은 말을 반복할 필요가 없습니다. 여러분에게도 유용할 수 있습니다.
이 저장소에는 다음을 위한 스킬이 포함되어 있습니다:
Fastify 개발을 위한 베스트 프랙티스 - 훅 라이프사이클, 플러그인 아키텍처, 성능 튜닝. Fastify 코어에서 여러 해 동안 작업한 경험을 바탕으로 합니다.
Node.js 개발을 위한 베스트 프랙티스 - 이벤트 루프 패턴, 비동기 에러 처리, 스트림 처리, 그리고 Node.js test runner. Node.js core에서 나온 일반적인 함정과 현대적인 패턴도 담고 있습니다.
C++ 애드온, V8 내부 구조, libuv 패턴, 빌드 시스템을 포함한 깊은 내부 내용입니다. 가장 낮은 수준에서 Node.js를 이해하기 위한 것입니다.
고급 타입 시스템, 복잡한 제네릭, any 타입 제거. TotalTypeScript의 Matt Pocock에게서 영감을 받았습니다. 그의 강의는 정말 훌륭합니다.
gh CLI를 사용하는 Git 및 GitHub 워크플로. PR, 이슈, 릴리스, 저장소 관리까지 다룹니다.
Fastify 통합을 포함한 OAuth 2.0/2.1. RFC 6749와 @fastify/oauth2 작업을 바탕으로 합니다.
neostandard와 ESLint v9 플랫 설정으로 하는 린팅. 괜한 소란 없이 현대적인 린팅을 제공합니다.
Diátaxis framework를 따르는 기술 문서 작성 - 튜토리얼, 하우투 가이드, 레퍼런스, 설명.
각 스킬에는 마크다운 파일, 코드 스니펫, 설정 예제가 들어 있습니다. 제 AI 어시스턴트는 이것들을 읽고 코드 리뷰를 돕거나 새로운 기능을 작성할 때 이 패턴들을 적용합니다. 마치 숙련된 개발자가 여러분과 페어 프로그래밍을 하는 것과 같습니다. 다만 이쪽은 2022년에 언급했던 그 V8 플래그까지 기억합니다.
스킬은 open Agent Skills standard를 따릅니다. Anthropic이 시작했고, 이제는 많은 AI 에이전트가 지원합니다.
스킬은 다음으로 이루어진 폴더입니다:
SKILL.md에는 프론트매터에 name 과 description 이 필요하고, 그 뒤에 지침을 담은 마크다운이 옵니다. 에이전트는 먼저 메타데이터를 로드하고, 필요할 때만 전체 지침을 로드합니다.
이 표준은 OpenAI Codex, GitHub Copilot, Claude Code, skills.sh, 그리고 그 밖의 도구들과 함께 작동합니다. 게임 중심 에이전트도 하나 있습니다. 색다른 예시로 pi coding-agent를 확인해 보세요.
새 프로젝트를 진행하고 성능 최적화, 보안, 배포 패턴을 더 깊이 파고들면서 더 많은 스킬을 추가할 예정입니다. 이것이 유용하다고 느껴지면 알려 주세요!
github.com/mcollina/skills에서 확인해 보세요.
감사합니다!
