Install
npx skills add apollographql/skills누구에게 맞나
이미 Apollo GraphQL 도구를 쓰고 있고, 코딩 대리가 공식 스킬로 쿼리, 뮤테이션, 캐시를 쓰길 원하며 기억으로 옛 API를 섞고 싶지 않다면 이 스킬 세트가 더 맞다. Apollo 관련 기술을 쓰는 AI 코딩 대리를 향하며 Agent Skills 형식을 따른다. 형식 설명은
https://agentskills.io/
스킬은
https://skills.sh/
에서도 찾을 수 있다. 대화형 설치를 한 번 받아들인다고 가정한다: 먼저 스킬을 고르고 다음 대상 Agent를 고른다. 문서만 읽고 스킬을 이 기기 Agent에 쓸 생각이 없는 사람의 이득은 작다. 마법사에 여러 Agent 이름이 나온다. 설치 때의 선택지일 뿐 「이 제품들만 Apollo를 쓸 수 있다」는 뜻이 아니다.
3분 만에 첫 시도 끝내기
공식 설치는 페이지에 이 하나로 쓰여 있다:
npx skills add apollographql/skills
CLI가 대화형 설치를 이끈다: 먼저 넣을 스킬을 고르고 다음 대상 Agent를 고른다. 이는 이 기기 Agent의 스킬 설정을 바꾼다. 읽기 전용 조회가 아니다. 실행 전에 이 기기에 npx가 있고 곧 쓸 Agent 환경을 아는지 확인한다. 선택지를 본 뒤 확정한다. 잘 모르는 환경에서 Enter만 연타하지 말 것.
넣은 뒤 읽기 전용 대조를 한 번 한다. 페이지는 설치 후 네임스페이스가 있는 슬래시 명령을 쓸 수 있다고 쓴다. /apollo-skills:apollo-client는 Apollo Client 4.x for React의 queries, mutations, caching, local state에 대응한다. Agent에 이 명령을 보내거나 그 스킬로 기존 쿼리를 검사하라고 분명히 요청한다. 아직 업무 코드는 바꾸지 말 것. 성공 신호: 답이 Apollo Client 4.x / React로 쿼리나 캐시를 말한다. 스킬 미설치라고 하지 않는다. 데이터 층 전체를 다시 쓰기 시작하면 먼저 멈춘다.
사용 사례
사례 1: React 쿼리와 뮤테이션을 검사하거나 초안을 쓴다. /apollo-skills:apollo-client 설명에는 queries와 mutations가 들어 있다. 기존 GraphQL 작업을 Agent에게 주고 「Apollo Client 4.x로 React에서 어떻게 보낼지」만 묻는다. 발췌에 구체 hook 이름은 없고 다른 GraphQL 클라이언트와의 대조도 쓰지 않았다. 확인할 수 있는 것은: 이 스킬이 Client 4.x 쿼리와 뮤테이션을 덮는다는 것. 구체 API는 스킬 본문이나 프로젝트의 4.x 코드를 따른다. 곁들여 클라이언트 메이저 버전 전체를 올리게 하지 말 것.
사례 2: 캐시와 로컬 상태를 대조한다. 같은 스킬은 caching과 local state도 썼다. 작업은 읽기 전용 진단이어야 한다. 예: 「이 캐시 키 / 로컬 상태가 그 스킬에 비춰 타당한가」. 캐시 축출 전략의 완전한 목록은 쓰지 않았고 로컬 상태가 어떤 저장을 반드시 쓰는지도 쓰지 않았다. 검수는 논의가 Client 4.x 캐시나 로컬 상태에 머무는 것만 본다. Agent가 schema 변경이나 새 링크 미들웨어 추가를 권하면 이미 이 발췌 밖이다.
사용 경계
이는 Apollo GraphQL 도구와 기술의 스킬 모음이지 일반 GraphQL 튜토리얼이 아니다. Apollo 생태계를 떠나 이 슬래시 명령을 씌우면 페이지가 쓴 범위 밖이다. 슬래시 명령은 apollo-skills: 접두사를 단다. 발췌가 완전히 서술한 것은 /apollo-skills:apollo-client뿐이다. 다른 명령이 있어도 이 재료는 설명을 주지 않았다. 능력을 스스로 보태지 말 것.
설치 경로는 위의 npx skills add 대화형 마법사다. 다른 설치기를 나란히 두지 말 것. 마법사는 스킬과 Agent를 고르게 한다. 환경을 잘못 고르면 스킬이 잘못된 런타임에 쓰인다. 페이지에 제거 단계는 없다.
처음에는 읽기 전용 검사에서 멈춘다. 쿼리 변경, 캐시 전략 변경, Apollo Client 업그레이드는 먼저 Agent에게 바꿀 파일을 되말하게 하고 당신이 확인한 뒤 이어간다.