jevlaya
한국어
문서

에이전트 스킬

Claude Code, Codex 및 기타 에이전트 환경을 위한 드롭인 스킬입니다.

TypeSafe 에이전트 스킬은 AI 코딩 에이전트에게 TypeSafe API에 대한 완전한 컨텍스트를 제공합니다. 세 가지 질문 유형, 아키텍처 패턴, 그리고 평가를 구조화하는 모범 사례가 포함됩니다.

설치

터미널에서 다음 두 명령을 실행하십시오.

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
npx skills add typesafe-ai/skills --skill typesafe-ai

메시지가 나오면 에이전트를 선택하십시오. 설치는 기본적으로 프로젝트 로컬입니다. 전역으로 설치하려면 -g를 추가하십시오.

다음 프롬프트를 코딩 에이전트에 붙여넣으십시오.

Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.

GitHub의 SKILL.md를 읽거나 원시 Markdown을 직접 가져오십시오. 수동 설치의 경우 참조 파일을 포함한 skills/typesafe-ai 디렉터리 전체를 에이전트의 스킬 디렉터리에 복사하십시오.

중복 복사본을 피하려면 설치 방법을 하나만 선택하십시오.

업데이트

Claude Code 플러그인의 경우 다음을 실행하십시오.

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

업데이트를 로드하려면 Claude Code를 재시작하거나 /reload-plugins를 실행하십시오. 자동 업데이트를 활성화하려면 /plugin을 열고 Marketplaces → typesafe-ai → Enable auto-update를 선택하십시오.

skills.sh 설치의 경우 npx skills update를 실행하십시오. 수동 복사본의 경우 스킬 디렉터리 전체를 최신 GitHub 버전으로 교체하십시오.

예시 프롬프트

프롬프트에서 스킬을 지명하는 것, 즉 “use the TypeSafe skill”은 모든 에이전트에서 작동하므로, 아래 프롬프트는 모두 그렇게 합니다. Claude Code 플러그인을 사용하면 /typesafe:typesafe-ai를 직접 호출할 수도 있습니다.

  • 시작하기 좋은 프롬프트는 프로젝트에서 TypeSafe를 어디에 가장 잘 활용할 수 있는지 파악하도록 돕는 브레인스토밍 프롬프트입니다.

    Using the TypeSafe skill, explore the project and find opportunities for using
intelligent judgement to stand in for complex parsing or other fragile code.

  • API 키를 만들고 값싼 테스트 쿼리를 실행하여 TypeSafe를 가장 잘 활용하는 방법을 파악할 권한을 에이전트에 줄 수도 있습니다.

    Using the TypeSafe skill, run some experiments using the TypeSafe API key that I've
exported to `TYPESAFE_API_KEY`. Propose changes based on the most promising results.

  • 코드베이스의 문제를 해결해 주는 특정 쿡북을 에이전트에게 가리키거나, 쿡북 색인을 가리키고 프로젝트의 패턴과 유사한 패턴이 있는지 물어보십시오.

    Using the TypeSafe skill, analyze my code and see if there are any applicable
cookbooks (https://console.typesafe.ai/docs/cookbooks) that show how I could
refactor my code to be less fragile or complex.

좋은 바이브 코딩 원칙

  1. 위의 예시 프롬프트를 출발점으로 삼아 에이전트와 대화로 풀어 나가십시오.
  2. 계획을 검토하고 구현하기 전에 그것이 타당한지 확인하십시오.
  3. 상수(질문과 임계값)를 한곳에 모아 검토하기 쉽게 하십시오. 에이전트는 질문을 잘 쓰지 못하므로 함께 편집할 각오를 하십시오.
  4. 주장을 액면 그대로 받아들이지 말고, 에이전트가 자신의 가정을 검증하도록 독려하십시오.

일반적인 문제

에이전트가 스킬을 사용하지 않습니다

Claude Code 플러그인을 사용하는 경우 /typesafe:typesafe-ai를 호출하십시오. 다른 에이전트에서는 “use the TypeSafe skill”이라고 요청하십시오. 그래도 로드되지 않으면 설치 프로그램이 사용 중인 에이전트를 대상으로 했는지 확인한 뒤 에이전트를 재시작하십시오.

라우팅이 예상대로 작동하지 않습니다

질문과 임계값을 확인하십시오. 임계값이 너무 높거나(거짓 음성 발생) 너무 낮을(거짓 양성 발생) 수 있습니다. 질문을 더 구체적으로 다듬어야 할 수도 있습니다.

신뢰도 임계값을 모든 곳에서 사용하고 있습니다

최선의 선택지를 고르는 것만 중요하다면, 신뢰도 임계값을 설정하는 대신 신뢰도가 가장 높은 선택지를 고르면 됩니다. 특정 통계 알고리즘을 염두에 두고 있다면, 아마도 신뢰도 대신 확률을 사용해야 합니다.

TypeSafe 코드를 검토하기 어렵습니다

사람이 검토해야 할 가장 중요한 것은 질문과 TypeSafe 코드에서 사용되는 임계값 상수입니다. 이들은 너무 뒤지지 않고도 쉽게 찾을 수 있도록 하나의 코드 파일에 정의해야 합니다.

에이전트가 요청 또는 응답 필드를 지어냅니다

오래된 스킬이 원인일 수 있습니다. 위의 설치 방법으로 업데이트한 후 다시 시도하십시오.