Community생산성 & 협업github.com

매직 투두

사용자가 직접 해야 하는 작업을 구체적인 작은 단계로 나눕니다. '투두', '막혀 있어', '시작할 수 없어', '압도당했어', '계속 피하고 있어', '이거 좀 나눠 줘', '매운맛 N', '순한맛' 또는 '매운맛'이라고 말할 때, 또는 답변이 사용자만 할 수 있고 15분 이상 걸리는 작업으로 끝날 때 사용하세요. 에이전트가 스스로 할 수 있는 작업에는 사용하지 마세요.

매직 투두란 무엇인가요?

매직 투두는 사용자가 직접 해야 하는 한 가지 작업을 스파이스 레벨(1~5)에 따라 점점 더 작은 단계로 분해하는 AI 에이전트 스킬입니다. 사용자가 '투두', '막혀 있어', '압도당했어' 등과 같은 신호를 보내거나, 에이전트가 계획의 마지막에 사용자만 할 수 있고 15분 이상 걸리는 작업을 발견했을 때 자동으로 활성화됩니다. 에이전트가 직접 처리할 수 있는 작업(예: 버그 수정, 이메일 초안 작성)은 절대 사용자에게 넘기지 않습니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 작동하도록 설계되었으며, 작업을 단계별로 나누고 각 단계에 소요 시간과 담당자(사용자, 에이전트, 팀원)를 태그하며, 필요한 경우 ClickUp, Todoist, Linear, GitHub Issues 등과 같은 작업 관리 도구에 동기화할 수 있습니다. 주요 기능으로는 스파이스 레벨 조정('매운맛'/'순한맛' 명령어), 특정 단계 세분화('break step N down'), 세션 분할('next sitting') 등이 있으며, 출력 형식은 일관된 마크다운 구조를 따릅니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9heaven/adhd-agent-skills/tree/HEAD/skills/magic-todo

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

매직 투두은(는) 무엇을 하나요?

사용자가 직접 해야 하는 한 가지 작업을 구체적인 작은 단계로 나눕니다. 스파이스 레벨(1~5)은 단계가 얼마나 작아질지를 결정합니다.

사용 시기

사용자가 직접 해야 하고 다음 중 하나에 해당할 때 작업을 분해하세요.

  • 사용자가 요청하거나 시작에 어려움을 겪는 신호를 보낼 때 ("투두", "막혀 있어", "시작할 수 없어", "압도당했어", "계속 피하고 있어", "이거 좀 나눠 줘", "매운맛 N"), 또는
  • 아무도 요청하지 않았지만, 답변이나 계획이 사용자만 할 수 있고 15분 이상 걸리는 작업으로 끝날 때.

다음 경우에는 건너뛰세요.

  • 에이전트가 작업을 할 수 있을 때 ("버그 수정", "이메일 초안 작성"). 작업을 직접 수행하세요. 에이전트가 끝낼 수 있는 작업을 사용자에게 체크리스트로 넘기지 마세요.
  • 작업이 5분 미만의 한 가지 행동일 때. 해당 행동을 명시하세요.
  • 아무도 요청하지 않았고 사용자 부분이 15분 미만일 때. 작업을 간단히 나열하고, 스파이스 라인이나 푸시 제안 없이 작성하세요.
  • 사용자가 전체 백로그를 검토 중일 때. 목록을 보여준 후 최상위 항목만 분해하세요.
  • 사용자가 "분해하지 마" 또는 "그냥 알려줘"라고 말할 때. 당신이 모르는 사실 없이도 작동하도록 첫 번째 행동 하나만 제시하고, 해당 주제에 대한 분해는 건너뛰세요.

분해당 하나의 작업만 처리하세요. 사용자가 여러 작업을 제시하면 가장 긴급한 작업(금전 및 명확한 마감일 우선)을 분해하고 나머지는 이름만 나열하세요.

스파이스 레벨

스파이스 = 사용자에게 작업이 느껴지는 어려움 또는 스트레스 수준이지, 실제 어려움이 아닙니다. 스파이스가 높을수록 단계가 더 작아져서 시작하는 데 필요한 의지력이 줄어듭니다.

스파이스이름단계당 최대 시간일반적인 단계 수사용처
1순한맛30분3-4자주 하는 일상 작업
2중간맛15분5-7일반 작업 (기본값)
3매운맛10분8-10미뤄왔던 작업
4아주 매운맛5분11-15두려운 작업: 돈 추적, 세금 또는 정부 서류, 어려운 대화
5불맛2분16-25완전 마비 상태. 신체적 미세 단계 포함 ("노트북 열기", "은행 탭 열기")

단계당 최대 시간은 규칙입니다. 단계 수는 일반적인 작업이 나오는 결과일 뿐 할당량이 아닙니다. 작은 작업은 단계가 더 적고, 큰 작업은 더 많은 세션으로 나뉘며 단계가 더 커지지는 않습니다.

사용자가 레벨을 지정하지 않을 때 레벨 선택:

  • 2에서 시작.
  • 작업이 7일 이상 열려 있거나(작업 파일에 날짜가 있으면 확인), 사용자가 막혔거나, 회피 중이거나, 압도당했다고 말하면 +1.
  • 돈 추적, 정부 포털 또는 어려운 대화와 관련된 경우 +1.
  • 최대 5. 선택한 레벨과 이유를 몇 마디로 말하여 사용자가 "매운맛" 또는 "순한맛"이라고 응답할 수 있게 하세요.

명령어:

  • "매운맛" / "순한맛": +1 / -1로 다시 실행.
  • "N단계 분해": 해당 단계 하나에 대해 스파이스 +1로 스킬 실행, N.1, N.2, ... 번호 매기기.
  • "다음 세션": 분할된 작업의 다음 세션을 분해.

분해 작성

1. 맥락 읽기

단계를 작성하기 전에 에이전트가 볼 수 있는 것을 빠르게 최대 3회 읽습니다.

  • 사용자의 작업 파일(있는 경우 TODO.md, 노트 보관함, 이슈 트래커): 작업 줄, 날짜, 연결된 파일.
  • 작업 이름이 언급된 프로젝트 또는 클라이언트 노트.
  • 누락된 이름, 금액 또는 마감일에 대한 에이전트의 메모리.

단계에 실제 경로, 사람, 금액 및 마감일을 명시하세요.

첫 번째 응답은 항상 분해입니다. 처음에 질문을 하면 사용자가 시작하기 전에 결정을 내리게 하므로, 누락된 사실이 질문이 되지 않습니다.

  • 사실에 관계없이 단계가 동일한 경우: 사실 없이도 작동하도록 단계를 작성하세요 ("당신이 신청하는 포털을 여세요").
  • 사실이 단계를 변경하는 경우: 가장 가능성 높은 해석을 취하고 스파이스 라인에 그렇게 명시하세요 ("여권 갱신으로 가정합니다, 첫 여권이 아닙니다. 틀리면 말씀해 주세요."), 그에 맞게 단계를 작성하세요.
  • 이름, 금액 또는 날짜가 누락된 경우: 그것을 얻는 것이 단계입니다 ("Sam에게 API 키를 물어보세요"). 절대 임의로 만들지 마세요.

2. 단계 작성

  • 각 단계는 하나의 행동입니다: 하나의 동사, 하나의 대상. 절대 "그리고 나서"가 아닙니다.
  • 단계는 구체적입니다: 앱, 파일, 화면 또는 버튼 이름을 명시하세요. "은행 앱 > 명세서 > 10월 열기"가 "재정 확인"보다 낫습니다.
  • 1단계는 한 가지를 엽니다: 정확한 파일, URL 또는 앱. 2분 이하가 걸리며 결정이 필요 없습니다. 로그인, 비밀번호 찾기, 옵션 선택은 이후 단계입니다.
  • 마지막 단계는 눈에 보이는 완료 지점입니다 ("TODO 목록에서 항목 체크").

3. 각 단계 담당자 태그

  • [You]: 사용자만 할 수 있습니다. 여기에는 항상 다른 사람에게 메시지 보내기, 지불, 제출, 게시 및 삭제가 포함됩니다.
  • [Agent]: 에이전트가 할 수 있습니다 (초안 작성, 조사, 기록 확인).
  • [Name]: 팀원.

사용자로부터 아무것도 필요하지 않은 [Agent] 단계는 분해가 표시되기 전에 완료됩니다. 결과나 파일 경로와 함께 [Agent, done]으로 나열하세요. [You] 단계에 의존하는 [Agent] 단계는 목록에 남아 있습니다. 사용자가 해당 단계에 도달하면 수행하세요.

4. 시간 추가

  • 열려 있는 모든 단계 끝에 분 단위: [5 min]. 진정으로 알 수 없는 경우에만 범위 사용: [10-20 min]. 완료된 단계에는 시간을 표시하지 않습니다.
  • 총합 라인: 열려 있는 단계의 합계, 그 다음 현실적인 블록 = 합계 x 1.5, 5분 단위로 올림하여 시간 맹목성과 전환 비용을 포함.
  • 합계가 90분을 초과하면 작업을 세션으로 분할. 세션 1을 전체로 작성하고 각 이후 세션은 한 줄에 대략적인 시간과 함께 이름을 지정.

5. 단계를 단계로 그룹화

5단계 초과: 최대 5단계로 구성된 단계로 그룹화하고, 각각 짧은 굵은 이름과 시간을 부여. 번호는 1부터 N까지 연속으로 진행되며 절대 다시 시작되지 않으므로 "7단계 분해"는 항상 하나의 단계를 의미.

전송 전에 확인: 6단계가 있는 단계는 두 개의 단계로 분할.

출력 형식

첫 번째 줄은 스파이스 라인입니다. 각 단계 이름 뒤에 빈 줄을 남겨 목록 번호가 작성된 대로 렌더링되도록 하세요. 1단계는 굵게 표시됩니다.

스파이스 4 (아주 매운맛): 12일 열림 + 돈 추적. "매운맛" 또는 "순한맛"이라고 말씀해 주세요.

**준비 (5분)**

1. **[You] Acme와의 마지막 이메일 스레드 열기 [2분, 지금 하세요]**
2. [Agent, done] `invoices/acme-oct.pdf`에서 알림 초안 작성: `drafts/acme-reminder.md`
3. [You] 초안 읽기 [3분]

**직접 만들기 (8분)**

4. [You] 금액과 마감일을 인보이스와 확인 [2분]
5. [You] 당신처럼 느껴지도록 한 줄 변경 [3분]
6. [You] 초안을 스레드의 답장에 붙여넣기 [2분]
7. [You] 받는 사람 줄에 Acme의 Priya가 표시되는지 확인 [1분]

**보내고 마무리 (7분)**

8. [You] `invoices/acme-oct.pdf` 첨부 [1분]
9. [You] 보내기 누르기 [1분]
10. [You] 금요일에 "Acme 후속 조치"를 캘린더에 추가 [3분]
11. [You] `TODO.md`에서 "Acme 추적" 체크 [2분]

단계 합계 20분. 30분 블록 잡기.
완료된 모습: 알림 전송됨, 후속 조치가 캘린더에 있음.
Todoist에 하위 작업으로 추가할까요? (예 / 아니오)

도입부, 요약 없음. 마지막에 질문 하나만. 줄표(--) 사용 금지.

작업 관리자로 푸시 (예 응답 후에만)

  • "<작업 관리자>에 하위 작업으로 추가할까요? (예 / 아니오)"로 끝내세요. 예 응답 없이 작업을 절대 생성하지 마세요.
  • 예 응답 시, 에이전트가 가지고 있는 작업 관리자 도구(ClickUp, Todoist, Linear, Asana, GitHub Issues, 마크다운 파일)를 사용하세요.
    • 상위 작업: 이름 = 작업, 예상 시간 = 현실적인 블록, 설명 = 출처 + 스파이스 레벨.
    • 각 단계에 대한 하위 작업 하나, 각각 자체 분 단위 예상 시간, [You] 단계는 사용자에게 할당.
  • 기본 목록이나 프로젝트를 모르는 경우 한 번 묻고 답변을 기억하세요.
  • 확인: 상위 작업을 다시 읽고 하위 작업 수와 링크를 보고하세요. 그 전에는 성공을 보고하지 마세요.
  • 작업 관리자 도구가 없습니까? 대신 마크다운 체크리스트 또는 .ics 파일을 제공하세요.

함정

  • 에이전트가 그냥 수행해야 할 작업을 분해하지 마세요. 가짜 숙제가 가장 흔한 실패 사례입니다.
  • 일반적인 단계 수에 도달하기 위해 목록을 부풀리지 마세요.
  • "X 결정"은 한 단계에 너무 큽니다. "A 또는 B 선택: A = ..., B = ..."로 옵션을 작성하세요.
  • 다른 사람에게 막힌 경우: 마감일이 있는 한 번의 후속 조치로 분해한 후 보류하세요. 아직 시작할 수 없는 작업을 계획하지 마세요.
  • 작업 목록은 오래됩니다. 먼저 연결된 노트를 확인하여 이미 완료된 단계를 계획하지 마세요.

함께 사용

이 저장소의 adhd-mode는 모든 응답을 형성하고 사용자에게 도달하는 작업을 이 스킬로 전달합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬