작동 방식
연결된 저장소에서 풀 리퀘스트가 열리고 닫기 키워드와 함께 Willet 작업을 참조하면, 해당 작업이 in_progress로 이동합니다. 풀 리퀘스트가 병합되면 작업이 done으로 이동합니다. 이 연동은 작업의 상태를 앞으로만 진행시키며, 이미 완료되었거나 취소된 작업은 변경되지 않고, 다시 열리거나 되돌려진 PR이 작업 상태를 되돌리지도 않습니다. 상태 변경은 "Willet (GitHub)"으로 기록되며, PR URL은 작업 이력에 저장됩니다.
설정
연결은 대시보드가 아닌 Willet의 MCP 도구를 통해 관리됩니다. Willet에 연결된 AI 에이전트에게 설정을 요청하거나, 도구를 직접 실행하세요. Willet 조직의 관리자 또는 담당자 역할과 GitHub 저장소의 관리자 권한이 필요합니다.
- GitHub로 Willet에 로그인합니다. 저장소에 웹훅을 등록하는 데 필요한 권한을 요청할 예정입니다.
- 에이전트에게 조직 슬러그, 프로젝트 슬러그, 그리고 owner/repo 형식의 저장소를 사용해 link_github_repo 도구를 호출하도록 요청하세요.
- 저장된 GitHub 인증에 필요한 권한이 누락된 경우, 도구가 URL을 반환합니다 — 해당 URL을 열어 재인증한 다음 link_github_repo를 다시 실행하세요.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>PR에서 작업 참조하기
작업을 참조할 때는 사람이 읽기 쉬운 키(프로젝트 접두사와 작업 번호를 합친 WD-42 같은 형식) 또는 26자리 ULID를 사용하세요. PR 제목, 설명, 브랜치 이름 어디에나 참조를 넣고, 종료 키워드와 함께 사용하세요. 키워드 하나 뒤에 작업을 원하는 만큼 나열할 수 있습니다.
Fixes WD-12, WD-13 and WD-14종료 키워드
대소문자를 구분하지 않고 악센트도 무시하며, Willet이 지원하는 모든 언어에서 작동합니다. 표준 영어 키워드(close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed)는 물론, 독일어·스페인어·프랑스어·이탈리아어·일본어·한국어·터키어의 자연스러운 동의어도 인식합니다. 동사가 앞에 오거나 뒤에 오는 어순 모두 지원하므로("fix <작업>" 또는 "<작업> fixed"), 동사가 문장 끝에 오는 언어에도 자연스럽게 대응합니다.
보안
연결된 각 저장소에는 매핑별 HMAC 웹훅 시크릿이 부여되므로, 서명되지 않거나 재전송된 웹훅으로는 작업을 이동할 수 없습니다. Willet 매핑이 없는 저장소에서 발생한 웹훅 이벤트는 무시됩니다. 연동은 저장소↔프로젝트 매핑 자체를 신뢰합니다. 연결된 저장소에서 PR을 머지할 수 있는 사람은 누구든 작업 상태를 변경할 수 있으므로, 작업을 업데이트할 권한을 주고 싶지 않은 기여자가 있는 저장소는 연결하지 마세요.