문서

후크

조직 수준의 자동화 기능으로, 작성한 지침에 따라 플랫폼 이벤트에 대응합니다.

하나의은 Coroid에서 발생하는 특정 상황에 반응합니다. 원하는 이벤트를 선택하고 일반 언어로 지침을 작성하면, 해당 이벤트가 발생할 때 훅이 실행됩니다.

해당 항목은 다음 경로에서 확인할 수 있습니다:설정 → 자동화 → 자동화.

대응 가능한 이벤트 목록

분류예시
작업생성됨, 상태 변경, 단계 변경, 완료, 실패
에이전트시작됨, 반복 처리, 도구 호출, 완료, 오류
저장소커밋 푸시, 브랜치 생성, pull request 개설, pull request 병합
분석종속성 발견, 보안 문제, 분석 완료
동기화외부 소스 업데이트
배포시작됨, 완료, 실패

기본적으로 읽기 전용으로 설정됩니다.

훅은 분석 및 보고를 수행합니다. 후속 작업을 생성할 수는 있지만, 코드를 직접 수정하지는 않습니다.

이러한 기본 설정 덕분에 안심하고 사용할 수 있습니다. 이벤트에 반응하여 코드를 편집하는 자동화 기능은 감독이 어려운 순간에 작동하기 쉽습니다. 반면 훅은작업을 개설함으로써 일반적인 프로세스 — 즉 명세, 계획, 검증, 리뷰, pull request — 를 통해 동일한 결과를 얻을 수 있습니다.

효과적인 지침 작성 방법

훅 지침은 모델이 처리하므로, 코드가 아닌 동료에게 전달하는 지침과 유사하게 작성됩니다. 그 품질 기준은명세와 동일합니다: 무엇을 살펴볼지, 무엇이 중요한지, 그리고 어떻게 할지를 명시하세요.

"아무것도 하지 않음" 경우를 명확히 정의해야 합니다. 이를 누락하면 훅이 매번 무언가를 보고하게 되며, 계속 실행되는 훅은 결국 무시되기 쉽습니다.

보호 장치

이벤트 기반 자동화는 예측 가능한 방식으로 오류가 발생하기 때문에 세 가지 보호 장치가 마련되어 있습니다:

**요청 제한.**분당, 시간당, 일별로 제한되며 훅별로 설정할 수 있습니다. 빈번하게 발생하는 이벤트에 대한 훅은 많은 병합 작업 중에 수백 번이나 실행될 수 있습니다.

**체인 깊이.**훅이 이벤트를 트리거하여 또 다른 훅을 실행할 수 있습니다. 최대 체인 깊이를 설정하면 무한 루프를 방지할 수 있습니다.

**도구 권한.**훅이 접근할 수 있는 범위는 엄격히 통제됩니다 — 읽기 전용 접근, MCP 호출 및 작업 생성 등은 별도로 관리됩니다.

권한

훅 관리 권한은 관리자에게만 부여됩니다; 모든 구성원은 훅과 그 실행 내역을 확인할 수 있습니다. 훅이 조직 전체에 영향을 미치므로 이러한 차이는 의도된 설정입니다.

모니터링 방법

각 훅은 전달 로그와 분석 정보를 저장합니다. 새 훅을 활성화한 후에는 로그를 확인하세요 — 오류가 아니라, 계속 실행되면서 아무런 조치도 유발하지 않는 경우가 문제입니다.

훅, 스케줄 및 Sentinel

작동 방식트리거 방식
플랫폼 이벤트
스케줄시간
Sentinel관찰 대상이 되는 조건