Setup Windows Workflow Capture
Запуск Навыка
При явном вызове или однозначном смысловом совпадении применяйте навык сразу. Перед первым шагом покажите ровно одну короткую контекстную строку (не более 30 слов) и продолжайте работу в том же ответе, не ожидая реакции:
Применяю экспериментальный навык «Настройка записи рабочего места в Windows» (обратная связь — @kir-kopylov): <кратко назовите конкретную пользу для текущего запроса>; продолжаю без ожидания.
Не включайте в строку author_github, внутреннее имя папки или пересказ всего запроса. Не спрашивайте, применять ли навык.
Если одновременно подходят совместимые навыки, выберите минимальный набор и покажите одну общую строку. Если подходы ведут к несовместимым результатам и запрос не позволяет выбрать, спросите только о желаемом результате, не о разрешении применить навык.
Запуск навыка не расширяет полномочия. Выполните всю безопасную и уже разрешённую часть; запросите подтверждение только непосредственно перед ещё не разрешённым внешним или изменяющим действием. Не запрашивайте повторно уже данное разрешение и не дублируйте системное окно подтверждения.
Обзор
Проведите коллегу по короткому маршруту от неизвестного Windows-компьютера до проверенного пробного файла. Повторяйте метод и критерии готовности, а не частные названия устройств или разрешение исходного компьютера.
Работайте по одному видимому шагу. Если состояние окна OBS неизвестно, попросите свежий скриншот и укажите одно следующее действие. Не называйте настройку готовой только потому, что OBS принял параметры или завершил запись без ошибки.
Естественные Входы
- "Настрой запись двух экранов для анализа работы";
- "Подготовь OBS на компьютере сотрудника";
- "Сделай такой же сетап записи рабочего места";
- "Проверь экраны, телефонию и микрофон перед двухчасовой записью";
- "Настрой 2 кадра в секунду и отдельные звуковые дорожки".
Обязательные Условия
До настройки подтвердите:
- сотрудник информирован о записи и согласованный интервал известен;
- личные сообщения и другие несогласованные данные не попадут в кадр;
- целевой компьютер работает на Windows и запись выполняется локально;
- пользователь разрешил установить OBS Studio и FFmpeg, если их нет.
Если согласие на запись не подтверждено, остановитесь до конфигурации. Не превращайте этот skill в средство скрытого наблюдения.
Процесс
Перед выполнением прочитайте known-exceptions.yaml и примените подходящее do_next_time.
1. Снять Фактическую Конфигурацию
Запустите scripts/collect_capture_readiness.ps1. Зафиксируйте Windows, CPU, RAM, GPU, свободное место, число и разрешения мониторов, аудиоустройства, наличие OBS, ffmpeg и ffprobe.
Не переносите с другого компьютера названия гарнитуры, размер холста или список кодировщиков. Если мониторов не два, остановитесь и согласуйте новый формат захвата.
2. Подготовить Инструменты
Если OBS или FFmpeg отсутствуют, найдите точный пакет через установленный менеджер пакетов, покажите пользователю, что будет установлено, и выполните установку в рамках подтверждённой настройки. После подключения новой USB-гарнитуры перезапустите OBS до выбора устройств.
3. Настроить OBS
Откройте references/obs-settings.md и ведите пользователя по одному экрану настроек. Основной профиль:
- холст: два обнаруженных экрана рядом слева направо без уменьшения;
- выходное разрешение равно холсту;
- частота: целое значение
2кадра/с; - контейнер:
MKV; - кодировщик:
x264, режимCRF 18, ключевой кадр2 s, нагрузкаveryfast, профильhigh; - аудио:
44.1 kHz,Mono,AAC 160 Kbps; - дорожка 1: общий звук; дорожка 2: телефония и прочий звук компьютера; дорожка 3: микрофон сотрудника.
Явно выберите вывод и микрофон USB-гарнитуры. Отключите лишние глобальные устройства, чтобы По умолчанию и явное устройство не создали дубль.
4. Разместить Экраны
Добавьте два источника Захват экрана. Назовите их по назначению, например экран 1 — рабочая система и экран 2 — коммуникации.
Первый источник поставьте в X=0, Y=0. Второй — в X=<ширина первого экрана>, Y=0. Размер каждого источника должен совпадать с его фактическим разрешением. Убедитесь, что нет перекрытия, чёрного зазора или уменьшения текста, затем заблокируйте оба источника.
5. Развести Аудио
В Расширенных свойствах аудио оставьте:
- звук компьютера: дорожки
1и2; - микрофон: дорожки
1и3; - остальные дорожки и неиспользуемые устройства: выключены.
Проведите две отдельные пробы индикаторов: сначала воспроизведите звук при молчащем сотруднике, затем остановите воспроизведение и произнесите фразу в микрофон. Должны двигаться разные индикаторы. Фраза нужна только для появления сигнала на дорожке микрофона; сравнивать её с системным звуком не требуется.
6. Сделать Пробную Запись
Следуйте references/verification-gate.md. Запишите 3–5 минут с изменениями на обоих экранах, системной речью или телефонным звуком и голосом сотрудника. Остановите запись и найдите фактически созданный .mkv.
Запустите scripts/verify_capture_recording.ps1, передав ожидаемые ширину, высоту и 2 кадра/с. Откройте три извлечённых контрольных кадра и прослушайте общий звук, дорожку компьютера и дорожку микрофона.
Если любой обязательный сигнал отсутствует, вернитесь только к соответствующему слою и повторите короткую пробу. Не переходите к двухчасовой записи по косвенному признаку.
Границы
- Не анализируйте содержимое рабочего процесса: этот skill только готовит и проверяет сбор материала.
- Не включайте облачную трансляцию, если пользователь просил локальную запись.
- Не меняйте драйверы, системный звук, реестр, политики безопасности или приложения сотрудника без отдельного решения.
- Не храните в repo клиентские скриншоты, записи, имена людей, контакты, пути или расшифровки.
- Не обещайте, что
2кадра/с достаточно для всех процессов. Это стартовая гипотеза; пригодность проверяется на материале после эксперимента.
Definition Of Done
Сетап готов только когда одновременно доказано:
- оба экрана полностью видны в контрольных кадрах, а рабочий текст читаем;
- файл имеет ожидаемые ширину, высоту и около
2кадров/с; - контейнер
MKVсодержит не менее трёх аудиодорожек; - на дорожке компьютера и дорожке микрофона есть отдельный слышимый сигнал;
- дорожка 1 позволяет прослушать общий ход работы;
- OBS во время короткой пробы не показывает пропущенные кадры или критическую нагрузку;
- рассчитанного свободного места хватает на согласованную длительность с запасом;
- итог помечен
READYс путём к пробному файлу и результатами проверки либоNOT READYс одним следующим действием.
Опрос После Использования
Опрос задаётся один раз — после вердикта READY, NOT READY с явным стопом или открытия PR по изменению skill, не посреди настройки компьютера. Если пользователь уже ответил «пропустить» в этой сессии, не переспрашивайте.
Опрос по skill:
1. Что в этом использовании podgotovka-windows-k-zapisi было полезно?
2. Что стоит доработать в skill или его формате?
Можно ответить коротко или написать "пропустить".
Если пользователь ответил, сохраните санированную карточку в ~/.codex/skill-runs/podgotovka-windows-k-zapisi/usage-feedback.jsonl — лучше через bundled script:
python3 scripts/log_usage_feedback.py --liked "..." --improve "..." --outcome "..."
Script перед записью редактирует приватные пути, контакты и token-like строки и сохраняет в JSONL redaction_applied и redaction_types. Если запись невозможна из-за sandbox, прав или отсутствия tools, не делайте вид, что лог сохранён: скажите об этом и покажите короткую JSONL-карточку для ручного сохранения. Raw-ответы, контакты, пути и секреты не коммитить.
Логирование Сбоев
Перед выполнением прочитайте локальный known-exceptions.yaml как список уже известных случаев и применяйте подходящее do_next_time без нового поиска.
Если пользователь поправил skill, tool/API/browser упал, нарушен режим работы, пришлось искать workaround или skill сделал ложное предположение, запишите приватную карточку в ~/.codex/skill-runs/<skill-name>/exception-log.jsonl.
Пишите факты: что skill хотел сделать, что сделал, где сломался, какая предпосылка была ложной и что сделать в следующий раз. Если поле неизвестно, пишите unknown. Raw logs не коммитить.