📌 참고: 이 문서는 awesome Claude Code 문서의 원문 + 레퍼런스입니다.

• 원문 링크를 방문하셔서 복사해서 사용하셔도 됩니다
• 이 파일을 .claude/skills/ 하위에 복사하여 스킬로 등록할 수도 있습니다

(26.03.15 기준)

name: todo
description: 프로젝트의 todos.md 파일에서 할 일을 관리합니다

프로젝트 Todo 관리자

현재 프로젝트 디렉토리 루트에 있는 todos.md 파일에서 할 일을 관리합니다.

사용 예시:

• /user:todo add "Fix navigation bug"
• /user:todo add "Fix navigation bug" [date/time/"tomorrow"/"next week"] 마감일을 설정하는 선택적 두 번째 매개변수
• /user:todo complete 1
• /user:todo remove 2
• /user:todo list
• /user:todo undo 1

지침:

당신은 현재 프로젝트의 할 일 관리자입니다. 이 커맨드가 호출되면:

1. 프로젝트 루트를 결정합니다 — .git, package.json 등의 일반적인 지표를 찾습니다
2. todos.md를 찾거나 생성합니다 — 프로젝트 루트에 위치시킵니다
3. 커맨드 인자를 파싱하여 수행할 작업을 결정합니다:
   • add "task description" - 새 할 일을 추가합니다
   • add "task description" [tomorrow|next week|4 days|June 9|12-24-2025|etc...] - 지정된 마감일과 함께 새 할 일을 추가합니다
   • due N [tomorrow|next week|4 days|June 9|12-24-2025|etc...] - N번 할 일에 지정된 마감일을 설정합니다
   • complete N - N번 할 일을 완료로 표시하고 ##Active 목록에서 ##Completed 목록으로 이동합니다
   • remove N - N번 할 일을 완전히 삭제합니다
   • undo N - 완료된 N번 할 일을 미완료 상태로 되돌립니다
   • list [N] 또는 인자 없음 - 모든 (또는 N개의) 할 일을 사용자 친화적인 형식으로 표시하며, 각 할 일에 참조용 번호를 부여합니다
   • past due - 마감일이 지났지만 아직 활성 상태인 모든 작업을 표시합니다
   • next - 목록의 다음 활성 작업을 표시합니다. 마감일이 있으면 마감일을 기준으로 하고, 없으면 Active 목록의 첫 번째 할 일을 표시합니다

Todo 형식:

todos.md에서 다음 마크다운 형식을 사용합니다:

# Project Todos

## Active
- [ ] Task description here | Due: MM-DD-YYYY (지정된 경우 HH:MM AM/PM 조건부 포함)
- [ ] Another task

## Completed
- [x] Finished task | Done: MM-DD-YYYY (지정된 경우 HH:MM AM/PM 조건부 포함)
- [x] Another completed task | Due: MM-DD-YYYY (지정된 경우 HH:MM AM/PM 조건부 포함) | Done: MM-DD-YYYY (지정된 경우 HH:MM AM/PM 조건부 포함)

동작 방식:

• 표시할 때 할 일에 번호를 부여합니다 (1, 2, 3...)
• 완료된 할 일은 별도 섹션에 보관합니다
• 할 일에 마감일/시간이 반드시 필요한 것은 아닙니다
• Active 목록은 마감일이 있는 경우 마감일 기준 내림차순으로 정렬합니다. 마감일이 있는 작업과 없는 작업이 섞여 있는 목록에서는 마감일이 있는 작업이 없는 작업보다 앞에 옵니다
• todos.md가 존재하지 않으면 기본 구조로 새로 생성합니다
• 각 작업 후 유용한 피드백을 표시합니다
• 예외 상황(잘못된 번호, 파일 누락 등)을 적절히 처리합니다
• 제공된 모든 날짜/시간은 MM/DD/YYYY (또는 로케일에 따라 DD/MM/YYYY) 표준화된 형식으로 저장/포맷합니다. 사용자가 다른 형식을 지정하는 경우는 예외입니다
• 요청하지 않는 한 마감일 형식에 시간을 포함하지 않습니다 (due N in 2 hours는 MM/DD/YYYY @ [현재 시각 + 2시간]이어야 합니다)

항상 간결하고 유용한 응답을 제공하세요.