Hook 타입¶
Agent Hooks는 각각 특정 자동화 시나리오를 위해 설계된 다양한 트리거 유형을 지원합니다. 이러한 유형을 이해하면 워크플로우 요구 사항에 적합한 접근 방식을 선택하는 데 도움이 됩니다.
Prompt Submit¶
사용자가 프롬프트를 제출할 때 트리거됩니다.
셸 명령 작업을 사용할 때 사용자 프롬프트는 USER_PROMPT 환경 변수를 통해 액세스할 수 있습니다.
사용 사례:
- 프롬프트와 관련된 추가 컨텍스트를 에이전트에게 제공
- 콘텐츠를 기반으로 특정 프롬프트 차단
- 모든 사용자 프롬프트를 중앙 위치에 로깅
Agent Stop¶
에이전트가 턴을 완료하고 사용자에게 응답을 완료했을 때 트리거됩니다.
사용 사례:
- 코드를 컴파일하고 실패를 에이전트에게 보고
- 에이전트가 생성한 코드를 포맷하거나 검토
- 에이전트가 수행한 변경 사항을 검토하고 추가 지침 제공
Pre Tool Use¶
에이전트가 도구를 호출하려고 할 때 트리거됩니다.
Tool name 필드에 이 hook이 실행되어야 하는 특정 도구(내장 또는 MCP)의 이름을 제공합니다. 와일드카드(예: "*")가 지원됩니다. Kiro에게 사용 가능한 도구의 이름을 물어볼 수 있습니다. 다음 특수 도구 이름이 지원됩니다:
- read - 모든 내장 파일 읽기 도구를 참조
- write - 모든 내장 파일 쓰기 도구를 참조
- shell - 모든 내장 셸 명령 관련 도구를 참조
- web - 모든 내장 웹 도구를 참조
사용 사례:
- 특정 도구 호출 차단
- 에이전트가 도구를 호출하기 전에 추가 지침 제공
Post Tool Use¶
에이전트가 도구를 호출한 후 트리거됩니다.
Tool name 필드에 대한 세부 정보는 위의 Pre Tool Use 섹션을 참조하세요.
사용 사례:
- 감사 목적으로 도구 호출 로깅
- "write" 도구 호출 후 업데이트된 파일을 포맷하거나 검토
- 도구 응답 위에 에이전트에게 추가 지침 제공
File Create¶
워크스페이스에서 특정 패턴과 일치하는 새 파일이 생성될 때 트리거됩니다.
사용 사례:
- 새 컴포넌트에 대한 보일러플레이트 코드 생성
- 새 파일에 라이선스 헤더 추가
- 구현 파일을 만들 때 테스트 파일 설정
File Save¶
특정 패턴과 일치하는 파일이 저장될 때 트리거됩니다.
사용 사례:
- 린팅 및 포맷팅 실행
- 관련 파일 업데이트
- 문서 생성
- 변경된 파일에 대한 테스트 실행
File Delete¶
특정 패턴과 일치하는 파일이 삭제될 때 트리거됩니다.
사용 사례:
- 관련 파일 정리
- 다른 파일의 import 참조 업데이트
- 프로젝트 무결성 유지
Manual Trigger¶
hook을 수동으로 실행합니다.
사용 사례:
- 주문형 코드 리뷰
- 문서 생성
- 보안 스캐닝
- 성능 최적화