ra-아이템
목표
사용자의 자연어 입력을 파일 작업으로 변환합니다. 사용자는 오직 말로만 명령합니다: 영감 기록, 링크 제공, 포맷 지정, 게시 보고. 카드 생성, 각색 라우팅, 항목 생성, 카드 이동, 칸반 등록은 모두 본 스킬이 처리합니다.
핵심 모델
- 아이템 카드 = 호적등본:
01-콘텐츠 생산/00-아이템 풀/YYYY-MM-DD-<주제>.md(_아이템카드템플릿.md기반). 아이디어, 출처, 판단, 항목 방향만 기록합니다. 본문은 항상 해당 작업대에 있습니다. - 항목 = 포맷을 결정하는 순간: 하나의 아이디어는 여러 포맷을 가질 수 있습니다. 각 포맷은 자체 작업대에 엔티티를 생성하고, 카드에는
- 포맷 → [[링크]]형태로 기록합니다. - 카드는 파일을 이동하지 않음: 항목화 시 frontmatter 상태만
항목 완료로 변경하고, 카드는00-아이템 풀/에 그대로 둡니다. - 호적등본 완전성 보장: 항목화 동작 시 카드가 없으면 자동으로 카드를 먼저 생성한 후 프로세스를 진행합니다(링크를 바로 던져 각색하는 경우 포함).
동사 표
1. 아이템 기록 (영감 xx / 아이디어 xx / 아이템 기록 xx / 이 링크 저장)
00-아이템 풀/에 카드 생성: 사용자 원문 + 요약 한 줄 설명 + 자료线索; 링크가 있으면출처:에 기록하고, 플랫폼 게시물 ID를 파싱할 수 있으면소스 ID:(<platform>:<post_id>)도 함께 입력- 상태 = 아이디어; 카드 경로를 응답하고, 추궁하거나 확장하지 않음
2. 아이템 심화 (심화 xx / xx 명확히)
- 카드 찾기(파일명 또는 제목으로 매칭), 자료 라이브러리/방법론 검색하여 관점, 훅, 사례를 '심화 노트'에 기록
- 상태 = 심화 중 (이미 항목이 완료된 카드는 상태 변경 안 함)
- 자연스러운 언어 규칙의 적용 범위: 노트 본문(관점/논거/자료/트래픽 판단)은 자유롭게 작성, 정보 밀도 우선,
ra-자연스러운언어전체 프로세스를 거치지 않음; 그러나 후보 훅, 오프닝 문장, 제목 방향, 명문구 등 완성 초안에 직접 들어갈 종자 문장은ra-자연스러운언어의 엄격한 금지 규칙('A가 아니라 B' 사용 금지, 정말/사실은/본질적으로, 콜론 강의체, 명령형 템플릿 시작)을 반드시 준수해야 합니다. 완전한 자연스러운 언어 정제 및 품질 관문은 항목화 각색 단계에서 실행되며, 심화 단계에서는 반복하지 않습니다.
3. 항목화 (만들기/제작 + 포맷; '비디오 기사 이미지 모두' 조합 가능)
포맷별로 라우팅하며, 각 포맷 완료 후 카드 '항목 완료'에 한 줄 추가하고, 마지막으로 카드 이동:
| 포맷 | 프로세스 | 배치 위치 |
|---|---|---|
| 비디오 (AI 영상) | 링크 있음 → ra-비디오-워시-파이프라인, 순수 아이디어/원고 → ra-각색 | 인계 원고 → 비디오 작업대/대기 중/<날짜-주제>/인계원고.md |
| 비디오 (자체 녹화) | 각색 후 녹화 대본 생성, 문서 상단에 '자체 녹화' 표기 | 비디오 작업대/대본/ |
| 기사 | 링크 있음 → 먼저 소스 텍스트 추출: TikTok/샤오홍슈 비디오 → ra-대본추출스킬; Bilibili/YouTube 등 비디오 → ra-비디오-워시-파이프라인의 추출 단계 재사용; 웹페이지/트윗 → Jina(https://r.jina.ai/<url>)로 본문 읽기 —— 소스 자료는 모두 비디오 작업대/.internal/에 저장 → 장문으로 각색(ra-자연스러운언어 + 방법론/공식계정 오프닝 방법론), dbs-ai-check로 진단하여 특정 지문 수정 → 기사 작업대/_기사템플릿.md에 따라 항목 생성(기사 하나당 한 폴더, 주 원고 + assets/, 주 원고만 저장) | 기사 작업대/작성 중/ + 게시 칸반에 '수정 대기' 등록 |
| 이미지 텍스트 | 샤오홍슈 카피 + dbs-xhs-title 제목 후보로 각색, _이미지전달템플릿.md에 따라 인계 원고 생성(이미지 생성은 Codex 담당) | 이미지텍스트 작업대/대기 중/ |
4. 게시 및 아카이빙 (xx 게시됨 / xx 수정 필요)
- 게시됨: 칸반의 해당 행 체크하고 '게시 완료' 로그로 이동(날짜/플랫폼); 기사 항목은
대기 중/에서게시 완료/로 이동 - 수정 필요: 칸반을 '수정 대기'로 되돌리거나 등록
5. 강의 영감 (이것은 강의로 만들 수 있음 / 강의 영감 xx / #강의영감)
02-강의체계/강의주제풀/영감기록.md에 한 줄 추가:- YYYY-MM-DD | 한 줄 영감 | 연결: [[아이템 카드 또는 작품]]- 축적만 하고 강의 구조는 확장하지 않음(비즈니스 시작 전까지 가장 가는 선 유지)
6. 아이템 추천 (N개의 아이템 추천 / 아이템 목록 작성)
네 가지 경로에서 자료를 수집하여 N개 후보 출력(기본 10개):
- 클라우드 바이럴 DB:
automation/scripts/hot_monitor_local_job.sh read booms실행하여 최근 90일 최대 30개 경량 후보 읽기, R/M, life 및 주제별로 먼저 필터링; 선별된 샘플에 대해automation/scripts/hot_monitor_local_job.sh read work <클라우드 작품 ID>실행하여 L1/대본/지표 히스토리 읽기. 시한부 유형이고 기간 초과(게시일로부터 life_window_days 초과) 시 주제 자체는 추천하지 않고, 유형 유전자만 추출(예: '월간 결산', '길거리 인터뷰', '시즌 마케팅')하여 현재의 새 주제로 변환; 장수형은 직접 후속 가능 - 최근 3일 기회:
automation/scripts/hot_monitor_local_job.sh read recent 3 200 0실행하여 클라우드의 최근 3일 모든 신규 작품(미판정 바이럴 및 YouTube 포함) 읽기;has_more=true응답 시next_offset에 따라has_more=false까지 계속 읽기. 계정 커버리지 확인 필요 시automation/scripts/hot_monitor_local_job.sh read creators실행. 서버가 이미 TikTok, 샤오홍슈, YouTube 벤치마크 계정을 통합 스캔하므로, 기본적으로 TikHub를 직접 호출하여 중복 수집하지 않음 - 자체 계정 데이터:
데이터통계/대장에서 자체 계정 R값이 높은 주제를 우선 확대 - 포지셔닝 필터:
개인포지셔닝.md참고; 포지셔닝에서 벗어나지만 트래픽 잠재력이 높은 범용 주제는 등급을 낮추지 않음(트래픽 우선 원칙) - 워시 대조(하드 게이트): 첫 번째, 두 번째 경로의 클라우드 출력은 먼저 대장을 거친 후 필터링에 들어가야 함 —— 명령 끝에 파이프
| python3 automation/scripts/wash_ledger.py filter연결(예:bash automation/scripts/hot_monitor_local_job.sh read booms | python3 automation/scripts/wash_ledger.py filter).washed: true로 표시된 항목은 표시를 유지하지만 반드시 '워시 완료 <날짜> → <산출물>' 표시를 달아야 하며, 새 주제로 추천해서는 안 됨;washed_match.status=skipped는 '한때 제작 안 함'으로 표시;washed_suspect는 '워시 의심'으로 표시. 후보 보고 시 이번 배치에서 워시 완료/제작 안 함/의심 각 몇 건인지 설명
각 후보 형식: 주제 한 줄 | 증거(소스 바이럴+R/M 또는 벤치마크 신규 데이터) | 시한부 기간 | 권장 포맷(실습 장편/AI 영상/녹화/이미지텍스트/기사) | 관점 예측
사용자 선택 → 카드 생성: 클라우드 후보는 필터링된 JSON에서 직접 platform/post_id를 가져와 플랫폼별 표준 링크 조합하여 출처:에 기록(douyin→https://www.douyin.com/video/<post_id>, xhs→https://www.xiaohongshu.com/explore/<post_id>, youtube→https://www.youtube.com/watch?v=<post_id>), 동시에 소스 ID:(<platform>:<post_id>) 입력 → 포맷별 항목화; 실습 장편은 ra-실습기획으로 라우팅. 각색 측에서 초안 등록 시 --work-id <클라우드 작품 id> 함께 전달
클라우드 읽기 실패 시 명확히 보고해야 하며, 삭제된 _바이럴총괄.jsonl / _계정풀.md로 대체하거나 과거 심층분석/을 실시간 데이터로 가장해서는 안 됨.
하드 규칙
- 전 포맷 프라이버시 월: 소스 링크, 소스 제목, 소스 대본은 아이템 카드의
출처:필드와비디오 작업대/.internal/에만 허용됨; 모든 완성 초안, 인계 원고, 작업대 항목에는 소스 정보가 전혀 없어야 함. 사용자가 명시적으로 출처 표기를 요청한 경우는 예외. - 각색 중복 제거 대장: 대장은
비디오 작업대/.internal/각색대장.jsonl(소스 프라이버시 영역)에 있으며, 도구는automation/scripts/wash_ledger.py. 아이템 추천의 클라우드 읽기는 반드시filter통과; 모든 포맷 항목화 각색 전에는 반드시check('워시 완료' 적중 시 하드 스톱, 사용자 확인 대기); 인계 원고/완성 초안 작성 후 각색 측에서add로 등록. 대장 내용은 세션 내에서만 사용자에게 보고하며, 어떤 완성 초안에도 포함되지 않음. - 사용자는 파일 이동을 요청받지 않음; 본 스킬이 대신 수행하고 각 이동을 응답에 보고.
- 칸반 등록 분담: 기사 완료는 본 스킬에서 등록; 비디오/이미지텍스트 전달은 제작 측(Codex)에서 등록.
- 항목화 비디오는 여전히 2단계 방식 준수: 기본적으로 대기 중 큐까지만 진행; 사용자가 '직접 제작/직출/원스톱 서비스'라고 말해야 계속 제작 진행.