AI 만화극 제작 (순수 Agent 버전)
개시 규칙 (매번 따를 것, 예외 없음)
- 먼저
python scripts/h3d.py next --root <프로젝트>실행하고, 출력된 "유일한 명령"을 따르며, 지정된 reference를 먼저 읽습니다. 스스로 순서를 정하거나 건너뛰지 마십시오. - 사용자 확정 사항은 항상
h3d decide <id> <값> --quote "<사용자 원문>"으로decisions.json에 기록합니다 (화풍, 비율, 대사 정책, 설정화 엔진, 검증 정책, 편집 방식 등). 노트에만 적지 말고, 사용자를 대신해 결정하지도 마십시오. review/project-state.json을 수동으로 수정하지 마십시오. 상태는 오직build_stage_review.py에 의해서만 기록됩니다. 수동 수정 시h3d next가 차단으로 판단합니다. 6단계 기술 QA가PARTIAL이고 사용자가 확인 후 승인한 경우,--approve-stage 6 --override --reason "<사용자 이유>"를 사용하십시오.- 6단계 세그먼트별 결론은 항상
h3d verdict로review/verdicts.json에 기록합니다 (pass/warn/fail + 한 문장 이유 + 증거 이미지).acceptance_policy에 따라 분류합니다. 3a. 이미지 생성 백엔드는 사용자가 선택하며, 스스로 기본값을 설정하지 않습니다: 2단계 설정화, 4단계 구도 이미지 생성 전에 먼저h3d imagegen --detect --root <프로젝트>를 실행하여 감지된 사용 가능한 도구(사용 불가 도구는 이유 포함)를 나열하고 사용자에게 선택을 요청합니다. 하나만 감지되어도 물어봐야 합니다. 사용자 응답 후h3d imagegen --set <백엔드> [--stage 2|4] --quote "<사용자 원문>"을 실행합니다.h3d next가 선택되지 않았거나, 선택되었지만 현재 사용 불가능할 경우, 다시 질문하도록 변경합니다 (references/tooling.md§2.4.1 참조). 4a. 사용자가 결정해야 할 사항은h3d inbox를 사용하여 결정 수신함을 생성해 사용자에게 전달합니다 (예외만 나열). 사용자가 승인한 단계는h3d next에 따라h3d approve --auto를 실행합니다. 0단계, 캐릭터 설정화, 각 캐릭터의 음색은 항상 사람이 결정해야 합니다 (references/tooling.md§2.6 참조). - 두 개의 비디오 러너를 동시에 실행하지 마십시오. ledger에 waiting/running 상태의 작업이 있으면 새 작업을 보내지 않고 수신만 합니다 (
h3d collect). PARTIAL,duration_drift발생 시 중단하고references/tooling.md§4에 따라 처리하여 사용자에게 보고하며, 스스로 우회하지 마십시오.- 완성물 형식 기본값 = 장편 만화극: 스토리를 명확히 전달하는 것이 최우선이며, 원작의 모든 핵심 이벤트는 원인→과정→결과(동기, 시간/장소 전환 포함)를 설명해야 합니다. 에피소드당 초 수로 이벤트를 압축하지 않습니다. 기본적으로 에피소드를 나누지 않고 하나의 연속 장편 영상으로 제작합니다. 숏드라마/세로형 인기 숏 에피소드(1-2분, 강력한 후크)는 사용자가 명시적으로 요청할 때만 사용합니다 (
h3d decide series_format short). 압축, 생략, 또는 설명이 부족한 이벤트는 Agent가 원작에 따라 보충합니다 (event_coverage.py). 스스로 삭제하거나 사용자에게 묻지 않습니다. - 대본 각색 시 사용자에게 묻지 않습니다: 항상
references/adapt/dialogue-first-adaptation.md를 따릅니다 (원작 대사는 전부 유지, 서술만 된 대화는 보충 작성하고invented표시, 내레이션 = 주인공 내면 음성 VO ≤30%, 에피소드 길이 제한 없음, 자연스러운 이야기 지점에서 끊고 원작 앵커 + 이유 기록, 제출 전adapt_gate.py전부 통과). - 작업 시작 전에 스킬 버전을 먼저 확인합니다:
h3d --version이 프로젝트review/project-state.json에 기록된 생성 버전과 일치하지 않으면, 먼저 스킬을 동기화한 후 작업을 시작합니다. 동일한 프롬프트라도 버전에 따라 다른 임계값(한 문장 15→18자, 말하기 비율 60%→90%, 컷 길이 하한 2.0→1.2초, 신규 D2 밀도 및 D4 개방)이 적용되므로, 이전 버전 규칙으로 수정하면 한 번의 작업이 무의미해집니다. 설치 디렉토리의 skills 복사본이 반드시 git repo는 아닙니다. 로컬에 소스 repo가 있으면 먼저 pull한 후 전체를 덮어쓰고, 덮어쓰기 전에 백업합니다. - 수정은 한 번에 배치로 하며, 문장별로 재서명하지 않습니다: 동일한 유형의 문제(동일한 문장 패턴, 동일한 패키지 문제)는 모든 세그먼트를 한 번에 수정한 후, rebuild →
h3d bind→h3d compile→ 4/5단계 재서명합니다 (배치 = 먼저 각 컷을shot_intent와 대조하여 동일한 근본 원인인지 확인하고, 경고 유형별로 일괄 수정하지 않음. 5단계에서 수정된 세그먼트는 세그먼트별 승인 절차를 따르며--segments를 사용하고--auto를 사용할 수 없음). 매 문장 수정 시마다 재서명하면 전체 검토 시간을 소모하며, layer2와 segments 지문이 동기화되지 않으면 5단계에서 차단됩니다. Rebuild는sketch_*필드를 지우므로, rebuild 전에 shot_id로 스냅샷을 저장하고 rebuild 후에 다시 기록합니다. 세그먼트 수 또는 세그먼트 코드가 변경되면 REMIX의 스토리보드 테이블도 동기화합니다 (PUT /projects/{id}/storyboard): 인터페이스/리뷰룸의 "예상 N컷"과 챕터 그룹화는 해당 문서를 읽으며,segments-*.json을 읽지 않습니다. 교체하지 않으면 항상 이전 계획(예: 133컷 vs 실제 18세그먼트)이 표시됩니다. 교체 전에 먼저GET /jobs?project=<id>를 사용하여 기존 코드에 연결된 작업이 없는지 컷별로 확인합니다. 없으면 전체를 덮어씁니다. 사용자가 "뽑기", "직접 리뷰/수정/사이클 진행"을 요청하면 = 자율적으로 전체 라운드(전송→수신→프레임 추출 리뷰→수정→재추출)를 실행하며, 인간 개입 지점(6단계 승인, 사용자에게 사유 요청)에서만 중단됩니다. 보고는 "라운드 + 4격자 증거 이미지 + 수정 사항" 단위로 하며, 추출할 때마다 보고하지 않습니다. - 참조 패키지가 프롬프트를 overriding합니다: REMIX의 패키지 마더샷에 있는 것은 모든 컷에 나타납니다 (마더샷의 발광 건물, 배낭, 밤하늘 등 포함). 변경하려면 패키지를 교체하거나 마더샷을 다시 생성하고, 프롬프트에서 부정문을 사용하여 억지로 수정하지 마십시오. 소품을 언급하면 소품이 나타납니다. 자세한 내용은
references/remix-draft-loop.md를 참조하십시오. - 승인 버전과 최종 버전은 별도로 보관하며, 버전 변경 시 재검증이 필요합니다:
videos/<세그먼트>.mp4는 항상 "QA 통과 및 서명 완료" 버전을 저장합니다.pika768최종본, 업스케일, 재추출 후보는videos/final-768/등의 하위 디렉토리에 저장합니다. 최종본을 승인 버전으로 승격하려면 =h3d qa/motion/--continuity재실행 → 6단계 스냅샷 재구성 → 사용자 재서명을 수행합니다. 파일을 직접 덮어써서 버전을 교체하지 마십시오. 서명된 스냅샷과 증거가 일치하지 않게 됩니다.
개요
사용자가 지정한 전달 범위에 따라 소설 각색, 대본, 감독 스토리보드, 프롬프트를 완료하거나, 실제 사용 가능한 이미지/비디오 도구를 사용하여 미디어를 생성합니다.
텍스트 계획은 독립적으로 전달 가능합니다. 미디어 생성을 위해서는 해당 도구 또는 연결된 백엔드가 필요합니다 (FreeVideo는 선택적 어댑터이며, 모든 Agent가 비디오 생성을 내장하고 있음을 의미하지 않습니다).
실제로 생성 도구를 호출하지 않은 경우, 이미지나 비디오를 생성했다고 주장할 수 없습니다. 소설을 대본으로 직접 사용할 수 없으며, 항상 먼저 1단계 각색을 거쳐야 합니다.
기존 프로젝트(자신이 처음부터 시작한 것이 아님)를 인계받은 경우 감사 후 진행합니다: 먼저 references/audit-inherited-project.md를 읽고, 이전 Agent의 스토리보드를 따라 작성하지 마십시오. 잘못된 상위 단계는 모든 컷을 다시 작업하게 만듭니다. "중복 자산", "내용 오류" 판단 전에 항상 바이블과 원작 행 번호를 다시 확인하고, 이미지나 파일명만 보지 마십시오.
이 페이지는 작업 홈페이지입니다: 각 단계에서 할 일, 하지 말아야 할 일, 실행할 명령어를 설명합니다. 원리, 템플릿, 실전 확정 사항 및 전체 도구 목록은
references/skill-guide.md (원본 SKILL.md 전문, 챕터 변경 없음)에 있으며, h3d next가 읽어야 할 해당 파일을 가리킵니다.
사용 시기
- "이 소설/이야기를 만화극, 모션코믹, 숏드라마로 만들어 줘"
- "소설을 만화극 대본으로 각색해 줘"
- "스토리보드/컷 테이블/비디오 프롬프트 작성해 줘"
- "캐릭터 설정/캐릭터 바이블 디자인해 줘"
- "상품 자료로 라이브 커머스 숏 비디오 만들어 줘"
각 단계 작업 홈페이지
| 단계 | 할 일 | 하지 말아야 할 일 | 실행할 명령어 | 먼저 읽을 것 |
|---|---|---|---|---|
| 0 톤 설정 | 톤 설정 질문(소재, 매체, 화풍, 비율)을 한 번에 모두 하고, 각 질문에 추천값을 제공합니다. 대사 정책은 고정적으로 "원작 대사 우선"이며 묻지 않습니다. 완성물 형식 기본값은 장편 만화극입니다 (에피소드 수/초 수 묻지 않음. 사용자가 명시적으로 숏드라마를 요청할 때만 h3d decide series_format short). 화풍 기본 추천은 14번 "고풍 사실적 후도색・영화적 감각" (샘플 이미지 첨부, 변경 가능) | 사용자를 대신해 결정하지 않음. 볼륨 역추정을 건너뛰지 않음. 숏 에피소드로 기본 설정하지 않음. | init_project.py, h3d decide style/aspect_ratio | references/pipeline.md, references/styles.md |
| 1 각색 | 등급 유지, 이벤트 설명 완전성 (각 이벤트 원인→과정→결과, 누락된 경우 Agent가 보충), 대사 우선 각색 및 대사 예산에 따른 에피소드 분할, 단락 구조, 인과 관계 부채. 제출 전 adapt_gate.py 전부 통과 | 소설을 대본으로 직접 사용. 초 수를 맞추기 위해 이벤트 압축. 이벤트 설명을 스스로 삭제. | event_coverage.py, dialogue_budget.py, adapt_gate.py, h3d next | references/adapt/dialogue-first-adaptation.md, references/adapt/novel-to-manju.md, references/adapt/structure-and-pacing.md §영 |
| 2 설정화 | 이미지 생성 도구 감지 후 사용자 선택 (하나만 감지되어도 물어봄). 주인공 우선 이미지 생성, 자체 점검 후 재생성. 도구 확정 시 전집 잠금. 모든 대본 특수 효과는 자체 B- 특수 효과 카드와 검토된 참조 이미지가 있어야 함 (이미지 없으면 5단계 진입 불가, E56) | 이미지 생성 도구를 스스로 기본값으로 설정. 이미지 생성 도구 교체 시 병렬 비교하지 않음. 자동 승인 (얼굴과 의상은 항상 사람이 확인해야 함). | h3d imagegen --detect/--set (design_engine 기록), 검토 페이지 | references/consistency.md, references/styles.md |
| 3 대본 | 장면화 각색, 대사 예산 (캐릭터 말하기 속도 4.0/4.5/VO 5.5자/초, 말하기 비율 75–90%), 각색 차이, 최종 확정 전 블라인드 리뷰 (fresh subagent에게 대본 재료 패키지만 제공: build_blind_review.py --stage 3, 규칙은 references/blind-review.md 참조) | 예산 초과 상태로 전송. | estimate_duration.py --h3, sync_script.py | references/adapt/screenplay-format.md |
| 4 스토리보드 | 각 컷마다 먼저 shot_intent (관객이 이해해야 할 것)를 작성한 후 기술적 값을 결정하고, 각 선택 사항에 choice_why에 이유를 기록합니다. 카메라 움직임은 beat 감정에 따라 references/camera-moves-guide.md를 참조하여 move_preset 선택 (선택 이유를 스토리보드 테이블에 기록, 컴파일러가 전개, move_lint 경고). 각 세그먼트에 캐릭터 계정, 대사 컷에는 시선, 세그먼트 이음새에는 최종 상태 및 카메라 위치 변경 기록 (continuity-ledger.md). Ref2VA 기본값은 한 컷에 식별 가능한 얼굴 하나 (단일 인물 크롭, 캐릭터 카드 remix 시에는 이 제한 없음), 원거리 샷에는 사람 배치 금지, 초점 거리와 피사체 거리는 쌍으로 작성. | 해당 구도 PNG 없이 컴파일 진입. 경고 유형별로 일괄 수정, 통과를 위해 승인 내용 변경 (군중을 빈 좌석으로 변경, empty background 추가). 스토리보드 이미지에서 사람 변경 또는 핵심 소품 누락. | 구도 이미지 없을 때 h3d imagegen --detect/--set --stage 4 (사용자가 Codex 스토리보드/Qwen 연필 9격자/손 그림 선택, storyboard_engine 기록) → h3d next가 해당 도구의 명령어 제공 (Codex는 --model <사용자 지정 모델>), validate_storyboard.py | references/storyboard/shot-intent.md, references/storyboard/cinematic-director.md, references/storyboard/continuity-ledger.md; 격투/기술/특수 효과가 있으면 h3-combat-impact 추가 로드 (아래 절 참조) |
| 5 프롬프트 | 각 컷을 직접 작성 Layer 2 five_part_en (Camera/Motion/Performance/Light/Sound, Motion과 Performance는 상세히 작성해야 함. 각 문장은 보거나 들을 수 있는 결과에 대응해야 하며, 참조 이미지에 이미 있는 외모를 다시 작성하지 않고, 위치, 시선, 시작 및 종료 포즈, 핵심 소품을 작성). 스토리보드, 구도 이미지 및 이전 컷 상태를 읽은 후 작성. 컴파일러는 6부분 형식만 조합. 전송 전 prompt_sketch_audit.py를 실행하여 각 문장의 프롬프트↔구도 이미지 대조 (fl2v 세그먼트는 먼저 frame_pair_qa.py로 이미지 중첩) | 코드로 5소절 생성. 컴파일 후 segments 덮어쓰기. 메타 단어(authored/approved)나 금지 문장 쌓기로 처리. ack 없이 경고 무시. | h3d bind (참조 이미지 먼저 생성 및 바인딩), h3d author, h3d compile --check, h3d catalog --check | references/prompt-authoring.md, references/h3/prompt-formats.md, references/tooling.md; 격투/필살기 세그먼트는 동시에 h3-combat-impact 참조하여 작성 |
| 6 비디오 | 전송 → 수신 → QA → 동적 QA (광학 흐름 프리즈/정지, 자동 변속 목록 제안) → 경계 연속성 QA (실제 컷 포인트 + 경계 이음새 + 한쪽 정지 후보, 경고만) → --continuity-pairs 각 쌍에 대해 6열 연속성 체크리스트(location/prop/screen side/costume/light/effect) 응답 → 세그먼트별 결론 → 수신함 | 두 개의 러너를 동시에 실행. 타인의 job에 접촉. 드리프트 비디오를 QA에 사용. 계획된 초 수로 프레임을 추출하여 경계 판단 (먼저 --continuity로 찾은 실제 컷 포인트 확인). | h3d probe, h3d run --plan, h3d qa, h3d motion, h3d qa --continuity, h3d verdict, h3d inbox | references/tooling.md §2.5–2.8 (경계 QA는 §2.8.1), references/remix-draft-loop.md (remix 뽑기→리뷰→수정), references/speed-ramp.md, references/skill-guide.md "6단계 생성" |
| 7 자막 편집 | 승인된 액션 세그먼트 후반 작업 변속 (원본 영상 유지, 대사는 원래 속도), 음량, 각 캐릭터 음색 한 번에 확정, 전집 단일 편집 프로젝트, 전달 전 블라인드 리뷰 (build_blind_review.py --stage 7 프레임 추출 및 이음새, 규칙은 references/blind-review.md 참조) | 모든 대사, 내레이션, 화면 밖 음성은 H3 네이티브 생성 (외부 TTS 없음). 사용자를 대신해 음색 결정. 원본 비디오 덮어쓰기. 대사 구간 변속. | h3d ramp, h3d concat plan/build, h3d assemble; 편집 렌즈 (조언만 제공) scripts/craft/edit_review.py | references/tooling.md §2.7, references/skill-guide.md "7단계", references/edit/manju-editing-playbook.md (컷 포인트/전환/특수 효과/자막/등장 카드/배경 음악 ducking/음량), references/craft/murch-cut, references/craft/hamilton-action |
공식 단계 승인은 review/project-state.json을 기준으로 하며, build_stage_review.py --approve-stage (사용자 원문) 또는 h3d approve --auto (사용자가 승인한 단계)로만 수행됩니다.
비디오 생성 루트: 기본값 Ref2VA (FreeVideo, 단일 인물 크롭). 사용자가 콘솔 REMIX 캐릭터 팩으로 변경하는 경우 h3d decide video_backend remix로 확정, h3d bind는 캐릭터 팩으로 재바인딩, h3d compile은 remix 바인딩을 포함하여 REMIX 3열(스타일 앵커 시작, <Picture N>/<Video N>은 팩별로 각각 번호 매기기)을 생성, audit은 backend에 따라 분기 (전송 어댑터가 아직 연결되지 않아 FreeVideo 전송단에서 remix 세그먼트 전송을 거부할 수 있음. references/tooling.md §2.3.1c 참조).
5단계 검토 페이지는 ref2va 세그먼트에 대해 자동으로 refcheck/staging을 추가로 실행하여 알림으로 표시합니다 (remix 세그먼트는 audit 내에서 실행). 수동으로는 h3d refcheck (프롬프트에 언급된 캐릭터/생물/소품/군중은 모두 패키지에 있어야 함. remix는 차단, ref2va는 알림만) 및 h3d staging (위치 왼쪽에서 오른쪽, 시선, 카메라를 향하지 않음. 기본 경고, staging_gate strict에서만 차단)을 실행합니다. 자세한 내용은 references/tooling.md §2.3.1d를 참조하십시오.
5단계 세그먼트별 승인: 5단계 승인은 각 세그먼트의 지문을 기록합니다. 승인 후 일부 세그먼트만 변경된 경우 → 변경된 세그먼트(추가/삭제된 세그먼트 포함)만 재검토 대상이며, 변경되지 않은 세그먼트는 승인 상태를 유지하고 계속 전송 가능합니다 (h3d submit/h3d run이 자동으로 재검토 대상 세그먼트 건너뛰기 또는 전송 거부). 변경된 세그먼트는 항상 수동 재검토: build_stage_review.py --project-dir . --stage 5 --segments X,Y로 재검토 페이지 생성 → 사용자 통과 후 h3d approve --stage 5 --segments X,Y --user-note "<사용자 원문>", --auto 사용 불가. 이미 비디오가 있는 세그먼트가 변경되면 h3d deps --status에서 stale (prompt_stale)로 표시됩니다. 이전 스냅샷 또는 공유 부분(세그먼트 파일 외부, 바인딩되지 않은 세그먼트의 ack, 이전 단계)이 변경되면 전체를 재검토해야 합니다. 자세한 내용은 references/tooling.md §2.6을 참조하십시오.
순수 텍스트 초안은 미디어 생성까지 진행하지 않고 지정된 범위로 전달 가능합니다: h3d decide delivery_scope script-only|storyboard-only|prompts-only|full --quote "<사용자 원문>"으로 전달 종료점 확정 (확정 없음 = 전체 프로세스). h3d next가 종료점에 도달하면 done을 보고합니다. no_image 시 2단계는 텍스트 설정 카드만 요구합니다. 참고: no_image는 2단계만 해제하며, 4단계 이후에는 여전히 구도 이미지가 필요하므로 종료점은 3단계 이전이거나 별도로 결정해야 합니다. 8단계의 산출물과 HTML 검토 페이지 대응은 references/skill-guide.md의 "8단계 프로세스와 HTML 중단점"을 참조하십시오.
자세한 템플릿은 references/pipeline.md를 참조하십시오. 각 단계의 HTML 검토 페이지는 현재 디버그 페이지(검토 스냅샷 바인딩용)입니다. 사용자에게 전달하는 것은 h3d inbox 수신함이며, 사양은 references/review-page-spec.md를 참조하십시오.
격투/기술/특수 효과 세그먼트: h3-combat-impact 동시 로드
스토리보드나 프롬프트가 격투, 대련, 기술, 필살기/대기술, 한 방 제압, 변신, 마법 폭발, 특수 효과, 충격 프레임, 화면 진동 (또는 L3 이상 명중)과 관련된 경우,
h3-combat-impact (ayase0307/h3-combat-impact)를 동시에 로드하여 함께 사용합니다:
- 4단계: 해당 스킬의 필수 프로세스에 따라 캐릭터 기술, 교전 편성 (교환/결과), 특수 효과 레이어 및 카메라 움직임을 설계하고, 충격 포인트 리스트와 각 포인트의 충격 프레임 경로 (P0–P3)를 병기합니다. 감독 레이어 lint (
director_lint.py, warning)는 다음을 알립니다: 새 위치로 변경 시 먼저 설정 컷 제공, 대사가 180도 축을 넘지 않도록, 반전/나쁜 소식 후 반응 컷 추가, 시선 매칭 시 보이는 대상을 설명, 세그먼트 간 이음새는 액션 편집 또는 오버레이 전환 사용 (24frames.art 카메라 언어 참조, 각색). - 5단계: 격투 세그먼트의
five_part_en은 해당 스킬의 결정 카드에 따라 작성합니다 — 필살기 기본값은 "충격 프레임 시리즈" 세그먼트 (템플릿 F)로 작성하고,near-freeze/hangs poised/like a meteor/for two frames와 같은 H3 느린 단어 및 프레임 수 제어를 사용하지 않습니다. 충격 프레임 계획표 (타임코드, 타격 포인트, 강도, 경로, 조립 배율)는 해당 세그먼트의 스토리보드 비고/전달 설명에 작성합니다 (segments에는 현재 전용 필드가 없음). - 7단계: 승인된 격투 세그먼트는 충격 프레임 계획에 따라 변속 (
h3d ramp, 또는 해당 스킬의impact_frame.py ramp) 또는 합성 (impact_frame.py composite)합니다. 대사 구간은 원래 속도를 유지합니다. - 컷 길이: 충격 프레임 시리즈 세그먼트, 타격 숏 컷은 h3-video-prompting의 "각 컷 ≥2 s"보다 짧을 수 있으며, h3-combat-impact를 기준으로 합니다.
본 repo의 연동 작성법: references/storyboard/xuanhuan-combat-contract.md (전투 분기, 액션 성립 조건, 장소, 충격 3레이어, 카메라 속도 용어, 필살기 과정 체인) 및 references/storyboard/vfx-design-and-review.md (특수 효과 디자인 카드, 얼굴 보호선, 이미지 검수 및 수정, 부분 수정 작성법). 두 문서 모두 외부 스킬 증류본이며, H3에서 실측되지 않았습니다.
이는 참조이며, 본 스킬의 게이트를 변경하지 않습니다: validate_storyboard.py, h3d compile --check, h3d catalog --check는 정상적으로 통과해야 합니다.
4가지 결정론적 검사 (전달의 일부)
지속 시간 양자 (17n+5, metadata.frames 사용 전송), 증거 등급 (6단계는 VERIFIED 필요), 세그먼트 수준 의존성 원장 (h3d deps),
실패 카탈로그 (h3d catalog --check/h3d ack). duration_drift, PARTIAL, 이미 waiting 중인 job은 모두 "지금 계속할 수 없음"을 나타내며,
처리는 references/tooling.md §4를 참조하십시오.
감독 (요구 사항 원장, 제출 전 블라인드 리뷰와 병기)
h3d decide는 형식화된 확정 사항만 기록합니다. 사용자가随口 말한 선호도가 확정되지 않으면 잊혀지며, "사용자가 말한 것이 잊혀졌는지"를 묻는 검사도 없습니다. 감독자가 이 레이어를 보완합니다:
python scripts/build_requirements_ledger.py --root <프로젝트>로 요구 사항 원장을 구성합니다 (decisions.json의 각 확정 사항 원문 + inbox 미결 카드 + --quotes 수동 발췌),
--stage N/--all/--inputs는 "재료만 포함, 결론 제외" 검증 패키지를 별도로 구성하며, fresh subagent가 각 항목의 산출물 커버리지를 확인합니다 (템플릿 및 금지 사항은 references/supervision.md 참조).
블라인드 리뷰와 동일한 위치: 프로세스 요구 사항이지 게이트가 아니며, h3d 상태 머신을 변경하지 않습니다. 불통과 시 먼저 처리한 후 제출합니다. 기존 프로젝트 인계 시 첫 단계로 --all을 사용하여 누적 검증합니다 (references/audit-inherited-project.md와 함께 사용).
리소스 (색인)
references/tooling.md— h3d의 모든 명령어 및 검사 (명령어 실행 전 먼저 읽기). §2.5 확정/세그먼트별 결론, §2.6 수신함 및 자동 승인, §2.7 runner/probe/더빙/편집.references/skill-guide.md— 원본 SKILL.md 전문: 핵심 원칙 0–14, 프로젝트 구조, 6단계 실전 확정, 7단계 더빙 레이어, 전체 스크립트 목록.references/pipeline.md— 8단계 상세 프로세스, 질문 목록, 템플릿; 사운드 3레이어 결정 및 음량 표준.references/review-page-spec.md— 검토 페이지 사양: 사용자에게 전달되는 것은 결정 수신함 (레이아웃 순서, 카드 필수 필드, 금지 사항, 8단계 읽기 보기 6개 블록). 이전 단계 페이지는 디버그용으로만 사용.references/blind-review.md— 블라인드 리뷰 (fresh-eyes): 재료만 제공하고 결론은 제공하지 않는 재료 패키지 및 프로세스 (3/7단계 필수 실행.scripts/build_blind_review.py).references/supervision.md— 감독 (요구 사항 원장): 사용자가 말한 것을 항목별로 커버리지 확인 (각 단계 제출 전 필수 실행.scripts/build_requirements_ledger.py).references/document-standard.md— 단계 문서 표준 형식: 상태 카드 + 본문 + 수정 기록,h3d doc으로 작성하고 수동 수정 금지. "당신이 결정"은 자동으로 수신함에 들어감.references/audit-inherited-project.md— 타인 프로젝트 인계 ("당신이 인계", "이전 Agent가 엉망으로 만듦", "조언 좀 봐줘"): 감사 후 진행, 기계 생성 지문 임계값, 대사 파이프라인 3가지 잘못된 방식, REMIX 감사, 재구축 순서 및 지뢰 (재bind, 공식 카메라 움직임 동사, sketch 스냅샷 복원, 비지원 백엔드의 구도 이미지 생성).references/remix-draft-loop.md— remix 뽑기 사이클 (6단계):pika4804/6단계 선택, 참조 패키지가 프롬프트를 overriding하는 5가지 증상, 리뷰 3가지 사항, 3가지 흔한 오경보 (낮은 채도/테두리/톤 점프), 배치 수정 + 재서명, 수신 및 확정 순서.docs/skill-roadmap.html— 사람용 동적 로드맵 (8단계 동작, 산출물, 결정자, 정지 신호). 프로세스가 변경되면 내장된roadmap-data를 동기화해야 함 (tests/test_skill_roadmap.py대조).references/adapt/(각색),references/storyboard/(감독 스토리보드),references/consistency.md(자산 일관성),references/styles.md(스타일 고정 앵커),references/freevideo.md,references/model-profiles.md,references/minimax-h3.md및references/h3/(H3 상세 참조, 상위 h3-video-prompting에서 동기화),references/prompt-playbook.md,references/h3/camera-moves-handbook.md(상위 카메라 움직임 핸드북: 17가지 + Loop Forge 6가지 + 선협 불릿 타임, Colab 실측 표기),references/craft/(창작 렌즈, 조언만 제공, 게이트 변경 안 함),references/edit/(7단계 만화극 편집 핸드북, Concat/CapCut 초안 조사).- 격투/기술/특수 효과/충격 프레임: 외부 스킬
h3-combat-impact(ayase0307/h3-combat-impact), 위의 "격투/기술/특수 효과 세그먼트" 참조. references/revision-and-retry.md— 수정 시 변경 목록 + 연동 결론 필수 첨부, 동일 컷 재추출 최대 2회 후 레이어 진단, 검수 비교 원칙.references/storyboard/continuity-ledger.md— 캐릭터 계정, 스토리보드 검토 체크리스트, 3가지 방위, 위치 표, 리액션 샷, 세그먼트 이음새 최종 상태, 참조 이미지 용도.references/storyboard/spatial-consistency.md— 공간 일관성: 장면 마더샷을 평면도에 따라 그림, 벽면 할당 레이어 (선택적scripts/storyboard/wall_map.py), 구도 보드는 마더샷을 기준으로 함. 생물만 촬영하는 컷은 가게 내 참조에 바인딩 (老易 실험 2026-10, 방향성 증거). §6 화이트 모델 분업 및 정밀도 3단계 (Foyege, H3 실측 안 됨).- 형식:
references/schemas/(decisions, verdicts). Agent용 하드 규칙은AGENTS.md참조.