Communitygithub.com

zehuichan/vibe-harness

모델이 정보를 쉽게 찾고, 안전하게 동작하며, 컨텍스트를 효율적으로 사용할 수 있도록 모델 대면 도구 정의(이름, 설명, 파라미터 스키마 또는 시스템 프롬프트 섹션)와 스킬, 컨텍스트 로딩, 다단계 에이전트 워크플로우를 설계할 때 사용합니다.

vibe-harness란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 모델이 읽는 도구 정의, 스킬 설명, 컨텍스트 로딩 전략, 다단계 워크플로우를 설계할 때 '모델 경험'을 최적화하는 방법을 제공합니다. 모델이 최소한의 컨텍스트로 핵심을 파악하고, 필요 시 구체적인 정보를 지연 로딩하며, 중복을 제거하고 명시적인 범위 제한을 설정하도록 안내합니다. 주요 플랫폼에서 공통적으로 적용할 수 있는 일반 원칙(틀, 체크리스트 아님)을 다루며, 대부분의 에이전트 기반 개발 도구에서 바로 활용 가능합니다. 또한 도구 정의나 스킬 설명을 변경한 후에는 반드시 첫 턴 프롬프트 토큰 수를 비교해 변화를 측정할 것을 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zehuichan/vibe-harness/tree/HEAD/skills/agent-experience

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에이전트 경험

모델이 필요한 것을 찾고, 안전하게 동작하며, 컨텍스트를 작업에 집중할 수 있도록 설계하세요. 이는 지침이지 체크리스트가 아닙니다.

  • 최소 컨텍스트로 시작: 먼저 목적, 사용 가능한 동작, 제약 사항을 노출하고 필요할 때 자세한 지침을 로딩합니다.
  • 명시적 발견 가능성: 지연된 모든 리소스는 명확한 설명과 안정적인 검색 방법을 가져야 합니다.
  • 중요 제약 사항을 눈에 띄게: 권한, 파괴적 효과, 필요한 검증은 해당 동작 전에 표시합니다.
  • 제한된 출력 선호: 결과는 간결하게 요약하고 식별자나 경로로 세부 정보를 검색할 수 있게 합니다. 전체 로그나 문서를 덤프하지 마십시오.
  • 근접성 활용: 작업 결과와 함께 인접한 컨텍스트 중 일부를 제한된 양으로 포함합니다. 예: 스레드 답변과 함께 앞의 몇 개 메시지를 제공합니다. 생략과 잘림은 명시적으로 표시하고 더 많은 내용을 검색할 수 있는 방법을 제공합니다.
  • 총 작업량 평가: 컨텍스트 절약이 더 많은 검색, 반복 읽기, 실수를 유발한다면 무의미합니다.

도구 정의

  • 명백한 제약은 삭제합니다. 모델이 호출 결과로 학습하는 규칙(예: 없는 파일 읽기 실패, 전송 실패 시 배달 안 됨)은 생략합니다.
  • 동작을 설명하고 구현은 생략합니다. 도구가 무엇을 하고 무엇을 반환하는지만 적습니다. 내부 메커니즘, 모델이 결과에서 보는 출력 마커, 강제 세부 사항은 생략합니다.
  • 파라미터 규칙은 파라미터에 넣습니다. 기본값, 범위, 쌍, 설정 시점 규칙은 해당 파라미터의 설명이나 스키마에 속합니다. 구성에 따라 변하는 설명은 보통 변하는 부분이 파라미터에 속함을 의미합니다.
  • 각 사실은 한 번만 말합니다. 도구 정의를 시스템 프롬프트 섹션에서 반복하지 말고, 파라미터 설명을 도구 설명에 넣지 말며, 한 도구의 규칙을 다른 도구에서 반복하지 마십시오.
  • 변화를 측정합니다. 도구 정의를 변경한 전후의 첫 턴 프롬프트 토큰 수를 비교합니다.

스킬 및 에이전트 지침

  • 설명이 트리거입니다. 스킬의 설명은 언제 사용할지를 사용자나 작업이 사용하는 단어로 명시하고, 본문은 방법을 서술합니다.
  • 진입 파일은 짧게 유지하고 세부 내용은 링크로 연결합니다. 워크플로우와 보호 장치는 스킬 파일에 넣습니다. 미세 조정 예제와 긴 참조는 필요에 따라 로딩되는 파일에 넣고 진입 파일에서 직접 링크합니다.
  • 범위 제한을 명시적으로 밝힙니다. "지침이지 체크리스트가 아닙니다" 또는 "수정 없이 발견한 내용을 보고합니다"는 모델이 워크플로우를 적용하는 방식을 바꿉니다.
  • 진실의 원천을 가리킵니다. 지침은 소유 문서를 재진술하는 대신 연결하므로 내용이 표류하지 않습니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬