모범 사례¶
이러한 모범 사례를 따르면 개발 워크플로우를 향상시키는 안정적이고 효율적이며 유지 관리 가능한 hooks를 만드는 데 도움이 됩니다.
Hook 설계¶
구체적이고 명확하게¶
- 에이전트 프롬프트 액션을 사용할 때 에이전트에게 상세하고 명확한 지침을 작성합니다
- Hook당 하나의 특정 작업에 집중합니다
- 복잡한 작업에는 번호가 매겨진 단계를 사용합니다
철저한 테스트¶
- 배포하기 전에 몇 가지 샘플 시나리오로 hooks를 테스트합니다
- Hooks가 엣지 케이스에서 작동하는지 확인합니다
- 파일 관련 hooks의 경우 확장하기 전에 제한된 파일 패턴으로 시작합니다
성능 모니터링¶
- Hooks가 워크플로우를 느리게 하지 않도록 합니다
- 트리거 이벤트의 빈도를 고려합니다
- 효율성을 위해 프롬프트를 최적화합니다
보안 고려 사항¶
입력 검증¶
- Hooks가 예상치 못한 콘텐츠를 우아하게 처리하도록 합니다
- 잠재적인 엣지 케이스를 고려합니다
- 잘못된 형식이거나 예상치 못한 입력으로 테스트합니다
범위 제한¶
- 파일 관련 hooks의 경우 가능하면 특정 파일 타입 또는 디렉토리를 대상으로 합니다
- 불필요한 실행을 피하기 위해 정확한 파일 패턴을 사용합니다
- 전체 코드베이스에 대한 hooks의 영향을 고려합니다
정기적 검토¶
- 프로젝트가 발전함에 따라 hook 로직을 업데이트합니다
- 더 이상 필요하지 않은 hooks를 제거합니다
- 실제 결과를 바탕으로 프롬프트를 개선합니다
팀 협업¶
Hooks 문서화¶
- Hook의 목적에 대한 명확한 문서를 유지합니다
- 예상되는 동작의 예시를 포함합니다
- 제한 사항이나 엣지 케이스를 문서화합니다
구성 공유¶
- 팀 구성원 간에 일관된 hooks를 사용합니다
- 버전 관리에 hook 구성을 저장합니다
- 일반적인 팀 워크플로우를 위한 표준 hooks를 만듭니다
버전 관리 통합¶
- 버전 관리 시스템과 통합되는 hooks를 고려합니다
- 코드 리뷰 워크플로우를 위한 hooks를 만듭니다
- 팀 표준을 시행하기 위해 hooks를 사용합니다