Обучително видео
Гласът води, картината го следва: първо сценарий и звук, после слайдове или запис, синхронизирани по дължината на всяка реплика.
С кого говориш. Човекът може да не е технически: говори на български (или на езика, на който ти пише), с прости думи, без команди и пътища, освен ако не попита. Техническите стъпки ги правиш ти. Питай само за решенията, които са негови: съдържание, аудитория, език, визия, одобрения.
Скриптовете са в ${CLAUDE_SKILL_DIR}/scripts/ и се пускат с python3 -B ${CLAUDE_SKILL_DIR}/scripts/<скрипт>.py … — на Windows вместо python3 е командата, която doctor.py казва на реда „Python команда“ (python или py -3); слайдовете и рендерът — node ${CLAUDE_SKILL_DIR}/deck/render.cjs …; записът на приложение — ${CLAUDE_SKILL_DIR}/screencast/. Темите са в ${CLAUDE_PLUGIN_ROOT}/themes/. Работи на macOS и Windows (в Bash и в PowerShell): командите остават прости — без пайпове, && и пренасочвания.
Проектът е папката, в която работиш (repo на продукт или папка с документи). Всеки проект има свой Gemini ключ, който стои само на компютъра на човека (Keychain / Credential Manager); белегът на проекта е .training-video/project.json (id и име, без тайни).
Четири одобрения — без тях не харчиш пари и време
- Сценарий (текстът на репликите и планът на слайдовете/екраните).
- Цена — таблицата от
cost.py. Малки проби (до 3–4 реплики) не искат одобрение, пълното озвучаване — да. - Проба на гласа — първите 3 реплики (
narrate.py --sample 3); човекът ги слуша. - Визия — 1–2 готови слайда или кадъра от записа, преди целия рендер.
Ход
- Среда и ключ — при всяко пускане, преди всичко останало.
doctor.py <проект>. Каквото липсва, го оправи с разрешение на човека с командата, коятоdoctor.pyдава за тази система (brew / winget); за рендераnpm ciв${CLAUDE_PLUGIN_ROOT}, ако Claude Code не го е направил, иnpx playwright install chromium.- Ключът на проекта:
key.py check <проект>.OK→ продължаваш.НЯМА ПРОЕКТ→ кажи на човека, че папката ще получи малък файл.training-video/project.json(име и номер на проекта, без тайни — може да влезе в git) и попитай за името на проекта (предложи името на папката). После wizard-а.НЯМА КЛЮЧ→ ако пише, че има стар общ ключ, попитай „Да ползвам ли досегашния ви Gemini ключ и за този проект?“ (да →key.py setup <проект> --use-legacy). Иначе wizard-а.ОТХВЪРЛЕН→ wizard-а с--replace.
- Wizard-ът: първо кажи с прости думи какво следва: „Ще се отвори страницата на Google AI Studio — създайте ключ (Create API key) в акаунта, от който ще се плаща гласът за този проект, и го копирайте. После ще се появи прозорец, в който да го поставите; ключът остава само на този компютър.“ Пусни
key.py setup <проект> [--name „<име>“]— той отваря страницата и прозореца, проверява ключа в Gemini и го записва. Никога не искай ключа в чата и не го пиши никъде; ако човекът го постави в чата, кажи му да го изтрие от Google AI Studio и да направи нов. - Технически хора могат да ползват Vertex (
gcloud auth application-default loginиGOOGLE_CLOUD_PROJECT);GEMINI_API_KEYв средата важи за всички проекти — само за CI.
- Прием — ориентирай се сам, питай само каквото не личи.
- Какво има: файлове/папка в чата или на диска, Google Drive линк (през свързания Google Drive конектор, ако има такъв), уеб линкове, git repo на продукт (
.training-video/profile.mdв него означава, че продуктът е подготвен за видео). - Има PDF, а
doctor.pyказва „poppler (PDF): няма“ → попитай с един въпрос: „За да извадя текста и снимките от PDF-ите, трябва малка програма (poppler, около 35 MB). Да я инсталирам ли?“ При „да“ — командата отdoctor.py(brew / winget); при „не“ — чети PDF-ите директно, без снимки от тях. - Режим: по материали →
reference/materials.md; по код (запис на приложението) →reference/code.md. Ако има и двете, попитай кое е видеото. - По код — за коя роля. Видеото е за една роля на приложението (оператор, мениджър, администратор…): записът влиза като нея и показва само нейните екрани. Ролите вземи от профила на продукта или от кода (
reference/code.md, „Ролите — от кода“) и питай с готови отговори — етикетите, както ги казва приложението. Не пиши сценарий, преди огледът като ролята (survey.cjs) да е минал. - Питай накуп (с въпроси с готови отговори): за кого е видеото и какво трябва да могат след него; език на гласа (по подразбиране български); езици на субтитрите; дължина (по подразбиране 3–8 мин.); тема (
themes/, по подразбиране „Неутрална“; ако материалите имат свой бранд — предложи тема от тях); къде да се запише готовото (папка на Drive или на компютъра).
- Какво има: файлове/папка в чата или на диска, Google Drive линк (през свързания Google Drive конектор, ако има такъв), уеб линкове, git repo на продукт (
- Папка на видеото — извън плъгина и извън repo-то на продукта, по подразбиране в „Документи“ на човека:
<Документи>/Обучителни видеа/<кратко-име>-<дата>/(~/Documentsна Mac; на Windows%USERPROFILE%\Documents, може да е в OneDrive):video.json—{"name": "<файлово име на изхода>", "project": "<абсолютен път до проекта>", "lang": "bg", "voice": "Charon", "subtitles": ["bg", "en"], "theme": "neutral", "mode": "materials|code"}—projectказва чий ключ плаща гласа; за „по код“ още"product": "<repo>"и"role": "<роля>";script.json— сценарият (формат вscripts/lines.py);audio/,timeline.json,final/се правят от скриптовете;sources/— копие или извадки от материалите, от които е писано (extract.pyги разглобява), иsources/facts.md— фактите с източник.
- Сценарий. Правилата за текста са в
reference/script.md(тон, дължина,say, факти). Покажи го на човека като четим текст (по глави), не като JSON. Поправките — докато не каже „добре“. → одобрение 1. - Цена.
lines.py <папка>, послеcost.py <папка>; покажи таблицата. → одобрение 2. - Проба на гласа.
narrate.py <папка> --sample 3; дай на човека пътищата до трите.wav(или ги пусни: Macopen <файл>, Windowsstart "" "<файл>"). Ако тонът не е добър — смениvoiceвvideo.json(пробите на гласове:tts.py --probe --voice <име>) и повтори. → одобрение 3. - Визия. Според режима: 1–2 слайда (
reference/materials.md) или кадър от записа (reference/code.md). → одобрение 4. - Пълен глас.
narrate.py <папка>. Накрая печата отчет; всеки редREDO <id>: …→narrate.py <папка> --only <id> …, докато нямаREDO(вж.reference/voice.mdза изключенията). - Картина. Според режима — рендер на слайдовете или запис на екраните; пише
timeline.jsonиfinal/<name>.mp4. - Субтитри. Преведи сам
textна всяка реплика за всеки допълнителен език вsubs/<език>.json({"<id>": "превод"}): същият корпоративен тон, числа с цифри, имената както са в материалите. Послеsrt.py <папка> <name>. - Проверка —
reference/voice.md, „Финална проверка“. Не казвай „готово“, преди да минат всички точки; каквото не е минало, го кажи прямо. - Предаване. Ако човекът е посочил папка в Google Drive и има свързан Drive конектор — качи там с него; иначе — пътят до
final/. Кажи накратко: дължина, езици, цена, какво остава непроверено.
Тон — винаги
Професионален, корпоративен, за възрастни колеги — дори когато продуктът е за деца. Не детско, не рекламно, не „обяснение за начинаещи“. Подробно: reference/script.md. Гласът не се сменя между репликите: един voice, един стил, една температура за цялото видео (reference/voice.md).