훌륭한 에이전트를 작성하는 방법.md: 2,500개 이상의 코드베이스에서 얻은 경험을 요약한 자료입니다. 핵심 아이디어는 "당신은 유용한 프로그래밍 도우미입니다"와 같은 모호한 지시는 효과가 없다는 것입니다. 실제로 효과적인 것은 "당신은 React 컴포넌트에 대한 테스트를 작성하고, 특정 예시를 따르며, 소스 코드를 절대 수정하지 않는 테스트 엔지니어입니다"와 같이 구체적인 역할 정의입니다. agents.md 파일은 지능형 에이전트를 정의하기 위한 완전한 작업 매뉴얼 역할을 합니다. 여기에는 역할 위치 지정, 기술 스택 지식, 프로젝트 파일 구조, 워크플로, 실행 가능한 명령, 코드 스타일 예제, 그리고 가장 중요한 명확한 운영 경계가 포함됩니다. 분석 결과, 성공적인 agents.md 파일은 일반적으로 다음 관행을 따르는 5가지 핵심 요소를 발견했습니다. 1. 명령에 접두사를 붙이면 실행 가능한 명령이 파일의 시작 부분에 배치되고, 도구 이름만 표시되는 것이 아니라 npm test, pytest -v와 같은 전체 명령 매개변수와 옵션이 포함됩니다. 2. 텍스트 대신 코드 예시를 사용하세요. 세 개의 설명적인 단락보다 실제 코드 조각이 더 효과적입니다. 예상되는 출력 스타일을 직접 보여주세요. 3. 명확한 경계를 설정하고 AI가 절대 건드릴 수 없는 콘텐츠(예: 민감한 정보, 공급업체 디렉토리, 프로덕션 구성 등)를 명확하게 알려줍니다. "키를 절대 제출하지 마세요"는 가장 일반적이고 효과적인 제약 조건입니다. 4. 구체적인 기술 스택은 일반적인 "React 프로젝트"가 아닌 "React 18 + TypeScript, Vite 및 Tailwind CSS 사용"으로 작성해야 하며, 버전 번호와 주요 종속성을 포함해야 합니다. 5. 명령, 테스트, 프로젝트 구조, 코드 스타일, Git 워크플로, 운영 경계 등 6가지 핵심 영역을 다룹니다. 이러한 영역을 다루면 구성 파일을 최상위 수준으로 끌어올릴 수 있습니다. 실제 예제에서는 문서 인텔리전스 에이전트의 완전한 구성 예를 제공하여 위의 원칙을 실제 시나리오에 적용하는 방법을 보여줍니다. 이 구성에는 다음이 포함됩니다. • 역할 정의: 기술 문서 전문가, Markdown 및 TypeScript에 능숙 • 프로젝트 지식: 특정 기술 스택 버전 및 파일 디렉터리 구조 • 사용 가능한 명령: `npm run docs:build` 및 `npx markdownlint docs/` • 3단계 경계 시스템: 항상 해야 할 일, 먼저 물어봐야 할 일, 절대 금지해야 할 일. 구축할 가치가 있는 전담 지능형 에이전트 여러 개 @docs-agent: 코드를 읽고 문서를 생성하며, docs/ 디렉토리에만 씁니다. @test-agent: 테스트를 작성할 때 실패한 테스트 케이스는 삭제하면 안 됩니다. @lint-agent: 논리를 변경하지 않고 코드 형식을 수정합니다. @api-agent: API 엔드포인트를 구축하고 데이터베이스 스키마를 수정하기 전에 상담이 필요합니다. @dev-deploy-agent: 로컬 빌드 및 배포를 처리합니다. 개발 환경만 해당됩니다. 구현 시 권장 사항은 간단한 작업부터 시작하고 "일반적인 도우미"를 만들려고 하지 않는 것입니다. 함수 문서 작성, 단위 테스트 추가, 코드 오류 수정 등 구체적인 작업을 선택하세요. 가장 간소화된 구성에는 에이전트 이름, 간략한 설명, 그리고 구체적인 역할 정의, 이 세 가지 요소만 필요합니다. Copilot이 초기 구성을 생성하도록 돕고 실제 프로젝트에 맞게 조정할 수도 있습니다. 핵심은 최고의 에이전트 구성 파일은 한꺼번에 계획하는 것이 아니라 반복적으로 개선되어야 한다는 것입니다. 간단한 구성부터 시작하여 테스트하고, 에이전트가 오류를 발견하면 세부 정보를 추가하세요. 성공의 핵심은 모호한 안내가 아닌 구체적인 역할 정의와 자세한 운영 매뉴얼을 제공하는 것입니다. 블로그 주소:
