kdycron — .comm/queue/ 폴링 타이머 관리

개요

Claude Code ↔ Cowork 비동기 소통에서 .comm/queue/ 디렉토리를 주기적으로 폴링하여 Cowork 메시지를 자동 감지·보고하는 스킬.

사용법

/kdycron              → 기본 1분 간격으로 타이머 시작
/kdycron start        → 타이머 시작 (기본 1분)
/kdycron start 2m     → 2분 간격으로 타이머 시작
/kdycron stop         → 타이머 중지
/kdycron status       → 현재 타이머 상태 확인
/kdycron check        → 즉시 1회 확인 (타이머 없이)

워크플로우

인자 파싱

1. 인자가 없거나 start만 → 시작 모드 (기본 간격: 1m)
2. start <interval> → 지정 간격으로 시작 모드 (예: start 2m, start 30s)
3. stop → 중지 모드
4. status → 상태 확인 모드
5. check → 즉시 확인 모드 (1회성)

시작 모드 (start)

1단계: 경로 수집

프로젝트 CLAUDE.md에서 .comm/ 경로를 탐색한다. 없으면 아래 기본 탐색을 수행:

탐색 순서:
1. 현재 프로젝트의 .comm/queue/
2. CLAUDE.md의 "설계 산출물" 또는 "소통 채널" 섹션에서 참조된 외부 .comm/ 경로
3. 상위 폴더의 .comm/queue/ (있으면)

이 프로젝트(260311-freelancer-finance) 고정 경로:

• 경로 1: 현재 프로젝트 .comm/queue/
• 경로 2: 260311 plan D/.comm/queue/ (상대경로: ../../260311 plan D/.comm/queue/ 또는 CLAUDE.md에서 참조)

2단계: 기존 타이머 확인

CronList로 기존 kdycron 타이머가 있는지 확인한다.

• 이미 실행 중이면: "이미 타이머가 실행 중입니다 (ID: {id}, 간격: {interval}). 재시작하려면 /kdycron stop 후 다시 시작하세요." 출력 후 종료.

3단계: CronCreate로 타이머 등록

CronCreate를 호출하여 반복 작업을 등록한다.

프롬프트 템플릿:

.comm/queue/ 두 곳에서 Cowork(cw) 메시지를 확인해줘.
파일명 *-cw-* 패턴을 찾으면 내용을 읽어서 보고.
경로 1: {경로1}
경로 2: {경로2}

간격 → cron 변환:

4단계: 사용자에게 확인

타이머 시작됨:
- ID: {job_id}
- 간격: {interval} (cron: {cron_expression})
- 감시 경로: {경로 목록}
- 감지 패턴: *-cw-* (Cowork 발신 메시지)
- 자동 만료: 3일 후

중지: /kdycron stop

중지 모드 (stop)

1. CronList로 kdycron 관련 타이머를 찾는다
   • 프롬프트에 .comm/queue/ 또는 Cowork 또는 *-cw-*가 포함된 작업 탐색
2. CronDelete로 해당 타이머를 삭제
3. 확인 메시지 출력: "타이머 종료됨 (ID: {id})"
4. 타이머가 없으면: "실행 중인 타이머가 없습니다."

상태 확인 모드 (status)

1. CronList 호출
2. kdycron 관련 타이머 필터링
3. 결과 출력:
   • 실행 중: "타이머 실행 중 (ID: {id}, 간격: {interval})"
   • 없음: "실행 중인 타이머 없음"

즉시 확인 모드 (check)

타이머 없이 1회성으로 모든 .comm/queue/ 경로를 확인한다.

1. 경로 수집 (1단계와 동일)
2. 각 경로에서 *-cw-* 패턴 Glob 검색
3. 발견된 파일이 있으면:
   • 파일 내용을 Read
   • 기존 처리 완료 메시지인지 판별 (결과 섹션이 채워져 있거나 status: done이면 스킵)
   • 새 메시지만 사용자에게 보고
4. 없으면: "새 Cowork 메시지 없음" 출력

메시지 보고 형식

새 메시지 발견 시 아래 형식으로 보고:

새 Cowork 메시지 발견!

### {파일명}
- 유형: {task/info/question}
- 우선순위: {high/medium/low}
- 요약: {제목}
- 내용: {요청 내용 첫 3줄}

처리하시겠습니까?

주의사항

• CronCreate의 recurring 타이머는 세션 내에서만 유효 (세션 종료 시 자동 소멸)
• 3일 후 자동 만료
• 동시에 여러 타이머를 등록하지 않도록 기존 타이머 확인 필수
• OneDrive 동기화 지연(1~2분)으로 인해 메시지가 늦게 보일 수 있음