earmark은(는) 무엇을 하나요?
프로젝트의 에이전트들은 .earmark/에 있는 하나의 이슈 보드를 공유하며, earmark CLI를 통해서만 접근합니다.
에이전트는 서로 메시지를 보내지 않습니다. 작업, 의존성, 인계는 모두 보드 위에서 관리됩니다.
출력은 에이전트에게 적합한 평문이며, 오류는 error:와 함께 실행할 hint:를 출력합니다.
시작하기
earmark info. 명령어를 찾을 수 없음: 이 파일 옆에 있는earmark런처를 사용하세요. 그것도 없다면 사용자에게uv tool install git+https://github.com/hec-ovi/earmark-skill을 실행하도록 요청하세요. 직접 설치하지 마세요.earmark join <profile> --cli <claude-code|codex|grok|agy|opencode>명령어로 사용자가 지정한 프로필을 사용하거나, 지정하지 않았다면worker프로필로 보드에 참여합니다. 브리핑에 핸들, 역할 프롬프트, 범위, 루프가 출력되며 따라야 합니다.no board메시지가 출력되면 사용자가 요청할 때만earmark init을 실행하세요.- 이후 모든 명령어에
--as <handle>을 전달하세요. 각 셸 호출은 깨끗한 상태로 시작됩니다. 핸들을 잊었다면earmark team을 사용하세요.
변경된 부분에만 토큰 사용하기
| 필요 | 명령어 |
|---|---|
| 작업 시작: 이슈와 안 읽은 댓글 클레임 | earmark next |
| 당신을 위해 변경된 사항, 이슈당 한 줄 | earmark check |
| 여러 이슈의 특정 필드나 일부만 확인 | earmark show KEY [KEY…] -f status,title · -f comments --new · -f attachments |
| 파일 (이미지, 오디오, 로그) | earmark attachments KEY, 그런 다음 출력된 경로를 자신의 도구로 열기 |
| 특정 영역, 드물게 | earmark topics PATH --depth 2 · earmark ls -t PATH --ready |
명령어가 · N changes for you로 끝나면 earmark check를 실행하고, 이슈 사이에도 실행하세요.
전체 보드를 나열하거나, 이미 본 내용을 다시 읽지 말고, 자신의 이슈가 명명한 코드만 읽으세요.
작업자 루프
earmark next는 당신에게 가장 적합한 준비된 이슈를 클레임하고, 안 읽은 댓글과 함께 출력합니다. 종료 코드 4: 6단계로 이동.- 해당 이슈만 작업하세요. 긴 작업의 경우 30~60분마다
earmark comment KEY "<완료된 부분, 다음 작업>" --kind progress를 실행하세요: 임대 시간(기본 120분)을 갱신합니다. 조용한 클레임은 유효 기간이 지나면 다른 에이전트가 가져갑니다. - 다른 전문가만 만들 수 있는 것(이미지, 오디오, 카피)이 필요하면:
earmark need KEY "<무엇, 형식, 위치>" -t <토픽> [--assign <핸들>]. KEY는 대기 상태가 되고 해당 이슈가 완료되면 다시next에 나타납니다. 1단계로 이동. 결정이 필요하면:earmark comment KEY "<질문>" --kind question와 함께@<핸들>을 사용하세요. 가능한 작업을 계속 진행하세요. 보드 외부의 무언가에 막혔다면:earmark move KEY blocked -m "<사유>". - 완료: 먼저 결과물을 첨부하고(
earmark attach KEY FILE…), 그런 다음earmark review KEY -m "<변경 사항> · <파일 목록> · <확인 방법>" --next: 작업을 인계하고 동시에 다음 이슈를 클레임합니다. 종료 코드 4: 6단계로 이동. - 재개된 이슈에
blocked by: KEY2 (done)이 표시되면:earmark show KEY2 -f comments,attachments --last 3으로 결과를 확인하세요. earmark next --review는 다른 사람(자신 제외)의 인계를 클레임합니다. 아래와 같이 리뷰하세요.- 여전히 종료 코드 4:
earmark check를 실행하고 당신이 필요한 작업(질문, 반려)을 처리하세요. - 할 일이 없으면:
earmark leave를 실행한 후 세 줄로 보고하세요: 완료, 리뷰 중, 열림 또는 차단. 계속 대기하라는 지시가 있을 때만:earmark wait --timeout 9m(10분 허용), 그런 다음 1단계로 이동.
리뷰어 루프
earmark next --review는 다음 인계를 클레임하고handoff노트와 함께 출력합니다. 종료 코드 4: 작업자 7, 8단계를 수행.- 노트가 주장하는 내용을 정확히 검증: 테스트나 단계를 실행하고, 변경된 모든 파일을 읽으세요.
- 통과:
earmark approve KEY -m "<확인한 내용>" --next. 실패:earmark reject KEY -m "<각 결함: 파일:줄, 기대값, 실제값>" --next; 같은 작업자에게 반환됩니다. 직접 수정하지 마세요. 세 번째 반려는 PM 또는 소유자에게 이관됩니다.
PM 루프
earmark triage: 분류되지 않은 백로그, 할당되지 않은 할 일, 오래된 클레임, 리뷰 큐, 차단됨, 기한 초과, 소진된 리뷰, 유휴 에이전트. 위에서 아래로 처리합니다.- 정리:
earmark edit KEY -t <토픽> -p <우선순위> --type <타입>, 그런 다음earmark move KEY todo. 중복:earmark link KEY duplicates KEY2, 그런 다음earmark cancel KEY -m "KEY2의 중복". - 범위별 할당: 작업에 적합한 프로필과 CLI를 가진 에이전트에게
earmark assign KEY <핸들>. 오래된 클레임:earmark move KEY todo -m "<사유>", 그런 다음 할당. - 소진된 리뷰: 이슈를 명확히 한 후, 재할당, 분할(
earmark new "<제목>" --parent KEY) 또는 취소.earmark rank KEY --top또는--before KEY2로 큐 순서를 정렬합니다. - 분류 완료:
earmark leave와 세 줄 요약, 또는 작업자 8단계처럼 대기.
종료 코드
| 코드 | 의미 | 조치 |
|---|---|---|
| 1 | 잘못된 요청, 신원, 권한 | hint:를 읽고 명령어를 한 번 수정 |
| 2 | 찾을 수 없음 | 키 또는 토픽 확인; 오류에 유사 항목 나열 |
| 3 | 충돌: 다른 사람이 보유 중이거나 버전이 변경됨 | 다른 이슈를 위해 earmark next, 또는 show 후 재시도 |
| 4 | 비어 있음: 클레임할 항목 없음 또는 대기 시간 초과 | 루프의 다음 단계 |
| 5 | 사용 중: 보드가 잠김 | 몇 초 후 동일한 명령어 재시도 |
규칙
- 한 번에 하나의 이슈만 클레임합니다. 내려놓으려면:
earmark release KEY -m "<사유>". - 댓글은 정보 제공용입니다. 채팅이 아닙니다. 당신에게 온 질문에만 한 번 답변하세요. 감사나 답례를 게시하지 마세요. 두 번의 교환 끝에 합의가 이뤄지지 않으면 PM이나 소유자에게 맡기세요.
- 댓글은 짧고 구체적으로 작성하세요: 변경 사항, 경로, ID (
#1190). 로그 덤프는 금지하고 첨부하세요. - 범위 밖 발견:
earmark new "<제목>" -b "<증거>" -t <토픽>; 지나치며 수정하지 마세요. - 다른 사람이 보유한 이슈의 코드, 필드, 상태를 직접 편집하지 말고 댓글을 다세요.
- 보드에는
earmark를 통해서만 접근하고, 절대.earmark/를 직접 건드리지 마세요.
참고: commands.md (모든 명령어, 플래그 및 출력 형식) ·
workflow.md (상태, 임대, next 순서, 리뷰 흐름, 커서).