메뉴
Final build step — render all Marp slides, validate SSML, synthesize the course manifest, and package bundle.zip. Use when coherence review has passed and the course is ready for deployment. Triggered by the asset-builder agent.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Orchestrate end-to-end online course generation from a topic. Invoke when user asks to "create a course", "design a curriculum", "build online lectures", "강의 만들어", "코스 설계", "커리큘럼 짜", "섹션별 퀴즈 포함 강의", "TTS 스크립트 강의", or any request to produce structured learning material with slides + notes + scripts + quizzes. Also invoke for follow-ups — "재실행", "섹션만 다시", "업데이트", "이전 결과 개선", "코스 수정". Do NOT invoke for single-artifact requests (just a slide, just a quiz) — those should call the specific authoring skill directly.
Synthesize TTS audio from course transcripts with pluggable engines (OpenAI gpt-4o-mini-tts default, edge-tts fallback). Use when turning a class transcript.txt into per-slide MP3s plus a concatenated full.mp3, handling [slide N] / [pause:ms] markers, retries, and per-slide speaker_affect overlays. Triggered after coherence-review passes and before/within asset-build, or as a standalone step. Also invoke for "오디오 생성", "TTS 합성", "강의 음성 만들어", "voice 변경", "speed 조정".
Write TTS-ready transcripts with [slide N] cues, [pause:ms] markers, and optional SSML. Convert raw code/URLs/long numbers to speakable forms. Use when turning slides+beats into a narrator script. Triggered by the script-writer agent.
Author slide decks in Marp Markdown and render to HTML. Use when turning class beats into 4-7 slides per class, applying Marp frontmatter/layout rules, preventing overflow, or rendering via the marp CLI. Triggered by the slide-author agent.
Cross-artifact QA for the course pipeline. Verify LO coverage, Bloom balance, slide↔script cue alignment, note↔slide consistency, tone, quiz factual validity, and transcript speakability. Use when reviewing generated course assets before build. Triggered by the coherence-reviewer agent.
Plan a single class as a beat sheet (hook → teach → example → practice → recap) used jointly by slide, note, and script authors. Use when turning a class spec into beats, allocating duration across beats, or assigning visual/speaker cues. Triggered by the class-planner agent.
| name | asset-build |
| description | Final build step — render all Marp slides, validate SSML, synthesize the course manifest, and package bundle.zip. Use when coherence review has passed and the course is ready for deployment. Triggered by the asset-builder agent. |
coherence-reviewer가 overall: "pass" 판정한 뒤 수행. Idempotent — 여러 번 돌려도 결과 동일.
_workspace/99_coherence_report.json의 overall == "pass"BUILD_REFUSED: coherence not passedmarp CLI 설치 확인xmllint 또는 fallback 경로 확인zip 설치 확인모든 slide.source.md를 재렌더하여 slide.html을 갱신.
이유: 중간에 슬라이드만 수정되었을 수 있으므로 항상 최신 상태 보장 (idempotency).
find course/sections -name slide.source.md -print0 | while IFS= read -r -d '' f; do
dir=$(dirname "$f")
marp --html --allow-local-files "$f" -o "$dir/slide.html"
done
존재하는 transcript.ssml 각각에 대해 validate-ssml.sh 실행.
실패는 WARNING으로 격하 (txt는 항상 유효).
각 quiz.json 비즈니스 룰 검증:
course/manifest.json:
{
"course": {
"topic": "...", "audience": "...",
"depth": "...", "language": "ko", "tone": "...",
"total_duration_min": 120,
"build_ts": "2026-04-22T14:30:00Z",
"harness_version": "1.1.0"
},
"learning_objectives": [ /* from _workspace/01_architect_learning_objectives.json */ ],
"sections": [
{
"id": "S1", "slug": "01-intro", "title": "...",
"lo_ids": ["LO-1.1","LO-1.2"],
"quiz_path": "sections/01-intro/quiz.json",
"classes": [
{
"id": "S1.C1", "slug": "01-what-is-rsc", "title": "...",
"lo_ids": ["LO-1.1"],
"assets": {
"slide_source": "sections/01-intro/classes/01-what-is-rsc/slide.source.md",
"slide_html": "sections/01-intro/classes/01-what-is-rsc/slide.html",
"note_md": "sections/01-intro/classes/01-what-is-rsc/note.md",
"transcript_txt": "sections/01-intro/classes/01-what-is-rsc/transcript.txt",
"transcript_ssml": "sections/01-intro/classes/01-what-is-rsc/transcript.ssml"
}
}
]
}
],
"stats": {
"sections": 4, "classes": 10, "total_slides": 45,
"lo_count": 14,
"bloom_distribution": {"Remember":2,"Understand":4,"Apply":5,"Analyze":3},
"estimated_audio_duration_sec": 7200
},
"asset_errors": []
}
# 빌드 디렉토리 초기화 (stale artifact 방지)
rm -rf course/build
mkdir -p course/build
# course/ 를 zip으로 (단, build 자체와 _workspace 제외)
cd course
zip -r build/bundle.zip . \
-x 'build/*' \
-x '_workspace/*' \
-x '.DS_Store' \
-x '*/.*'
cd ..
_workspace/98_build_log.txt:
2026-04-22T14:30:00Z BUILD START
Marp render: 10/10 classes OK
SSML validate: 3/3 OK
Quiz schema: 4/4 OK
Manifest written
Bundle: course/build/bundle.zip (1.8 MB)
2026-04-22T14:30:42Z BUILD COMPLETE
coherence-reviewer가 overall: "pass"라도 asset_errors가 있을 수 있음:
이 경우 manifest.asset_errors에 기록하고 번들은 계속 빌드. 사용자에게는 "부분 빌드 완료, N개 이슈 있음" 알림.
BUILD_FAILED: marp CLI missing. Install: npm install -g @marp-team/marp-cli
재시도 1회. 재실패 시 tar.gz 대체 제안.
즉시 중단, 정리 요청.
매 빌드마다:
course/build/ 삭제_workspace/는 절대 건드리지 않음.