Communitygithub.com

training-video

Показва на агента как да планира, създава или монтажира „обучително видео“, така че конкретният изход да бъде използваем текст или скрипт. Процедурата преминава през Обучително видео, Четири одобрения — без тях не харчиш пари и време, и Стъпки. Използвай го, когато нова задача изисква тази дейност.

training-video 是什么?

Този скил предоставя на ИИ агента (Claude Code, Cursor, Codex и др.) стандартизиран работен процес за създаване на обучителни видеа, с фокус върху писането на скриптове и плановете за слайдове/екранни записи. Процесът е строго разделен на етапи: подготовка (среда, ключове за Gemini), събиране на изисквания (аудитория, език, тема), писане на сценарий, изчисляване на цена, гласова проба, визуален преглед (слайдове или кадър от запис), пълно озвучаване, рендер на картина, генериране на субтитри и финална проверка. Той гарантира, че всяка стъпка изисква одобрение от човека преди да се консумират ресурси (време, пари за TTS). Скилът поддържа два режима: „по материали“ (за презентации) и „по код“ (за запис на приложение), като се интеграции с Gemini за глас, локални скриптове (Python, Node.js), и работи на macOS и Windows (Bash, PowerShell). Ключовата му ценност е в това, че превръща разхвърляните инструкции в детерминиран, проверяем и икономичен процес, спестявайки време чрез автоматизация на повторяемите задачи (извличане на текст, TTS, рендер, субтитри).

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/erida-ai/training-video/tree/HEAD/skills/training-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Обучително видео

Гласът води, картината го следва: първо сценарий и звук, после слайдове или запис, синхронизирани по дължината на всяка реплика.

С кого говориш. Човекът може да не е технически: говори на български (или на езика, на който ти пише), с прости думи, без команди и пътища, освен ако не попита. Техническите стъпки ги правиш ти. Питай само за решенията, които са негови: съдържание, аудитория, език, визия, одобрения.

Скриптовете са в ${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 и име, без тайни).

Четири одобрения — без тях не харчиш пари и време

  1. Сценарий (текстът на репликите и планът на слайдовете/екраните).
  2. Цена — таблицата от cost.py. Малки проби (до 3–4 реплики) не искат одобрение, пълното озвучаване — да.
  3. Проба на гласа — първите 3 реплики (narrate.py --sample 3); човекът ги слуша.
  4. Визия — 1–2 готови слайда или кадъра от записа, преди целия рендер.

Ход

  1. Среда и ключ — при всяко пускане, преди всичко останало.
    • 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.
  2. Прием — ориентирай се сам, питай само каквото не личи.
    • Какво има: файлове/папка в чата или на диска, 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 или на компютъра).
  3. Папка на видеото — извън плъгина и извън 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 — фактите с източник.
  4. Сценарий. Правилата за текста са в reference/script.md (тон, дължина, say, факти). Покажи го на човека като четим текст (по глави), не като JSON. Поправките — докато не каже „добре“. → одобрение 1.
  5. Цена. lines.py <папка>, после cost.py <папка>; покажи таблицата. → одобрение 2.
  6. Проба на гласа. narrate.py <папка> --sample 3; дай на човека пътищата до трите .wav (или ги пусни: Mac open <файл>, Windows start "" "<файл>"). Ако тонът не е добър — смени voice в video.json (пробите на гласове: tts.py --probe --voice <име>) и повтори. → одобрение 3.
  7. Визия. Според режима: 1–2 слайда (reference/materials.md) или кадър от записа (reference/code.md). → одобрение 4.
  8. Пълен глас. narrate.py <папка>. Накрая печата отчет; всеки ред REDO <id>: … → narrate.py <папка> --only <id> …, докато няма REDO (вж. reference/voice.md за изключенията).
  9. Картина. Според режима — рендер на слайдовете или запис на екраните; пише timeline.json и final/<name>.mp4.
  10. Субтитри. Преведи сам text на всяка реплика за всеки допълнителен език в subs/<език>.json ({"<id>": "превод"}): същият корпоративен тон, числа с цифри, имената както са в материалите. После srt.py <папка> <name>.
  11. Проверка — reference/voice.md, „Финална проверка“. Не казвай „готово“, преди да минат всички точки; каквото не е минало, го кажи прямо.
  12. Предаване. Ако човекът е посочил папка в Google Drive и има свързан Drive конектор — качи там с него; иначе — пътят до final/. Кажи накратко: дължина, езици, цена, какво остава непроверено.

Тон — винаги

Професионален, корпоративен, за възрастни колеги — дори когато продуктът е за деца. Не детско, не рекламно, не „обяснение за начинаещи“. Подробно: reference/script.md. Гласът не се сменя между репликите: един voice, един стил, една температура за цялото видео (reference/voice.md).

相关技能