Pi Harness лучше Codex / Claude? (любимый фанатами)

Агент по созданию субтитров не должен каждый день заново изучать написание названий ваших продуктов. Координатор видео не должен иметь полную историю каждой правки субтитров и эксперимента с анимацией. Назначьте каждому заданию чёткого исполнителя, храните полезные инструкции на диске и возвращайте выполненную работу с достаточными доказательствами для проверки.

Начинайте с одного работника Pi. Пример ниже — это повторяющийся видеомонтаж: субтитры, анимация, удаление тишины, музыка и финальная сборка. Тот же метод можно использовать для регулярного обслуживания веб-сайтов или других производственных задач с определяемыми входными и выходными данными.

Архитектура происходит из производственного рабочего процесса Лéo. Приведённые ниже команды настройки являются дополнительными рекомендациями, проверенными по официальной документации Pi 28 октября 2026 года. Они создают целевого рабочего; они не устанавливают полную систему управления панелями Лeo и не претендуют на воспроизведение его производственных результатов.

Решите, заслуживает ли задача участия специалиста

Начните с работы, которую вы уже успешно выполнили. Сохраните входные данные, принятый результат, важные инструкции и проверки, которые выявили ошибки. Это даст вам что-то конкретное для воспроизведения.

Первоначальный прототип веб-сайта или MVP игры часто слишком нестабилен для коллектива узкоопределённых работников. Вы всё ещё можете решать, что именно создавать. Лео предпочитает Codex или Claude Code для этой исследовательской стадии, потому что, по его опыту, им требуется меньше точного руководства и они охотнее выполняют широкие задания. Он также упоминает DeepSeek в числе своих первых выборов для создания. Это предпочтения из его работы, а не контролируемый рейтинг используемых моделей.

Как только задача повторяется, запишите, что остаётся неизменным. Для субтитров это может быть смешение языков, фирменная лексика, формат вывода и процесс проверки. Записи и отдельные предложения меняются; правила исправления нет. Это полезная граница для специалиста.

Не начинайте с создания пяти агентов. Начните с того, чтобы сделать одну задачу повторяемой. Разделение нечёткой задачи между большим количеством исполнителей даёт больше неясных результатов, которые придётся согласовывать.

Разделите модель, исполнителя и координатора

Pi — это программная оболочка для кодирования: программное обеспечение, которое подключает модель к инструментам и управляет разговором и работой вокруг неё. GPT и Claude — это семейства моделей. Установка Pi не устанавливает маленькую модель под названием Pi.

В этой схеме координатором является Codex или Claude Code. Он владеет инструкцией, распределяет работу, проверяет зависимости и решает, соответствует ли окончательный результат запросу. Работники Pi выполняют более узкие задания. Инструмент управления панелями является дополнительным компонентом, который позволяет координатору достигать этих работников. Лео назначает Herder на эту роль и продолжает использовать его вместе с Pi; Pi не заменил Herder.

Компонент	Ответственность на примере видеомонтажа
Координатор	Понимать полную запись, решать, как смонтировать, распределять задания, проверять и собирать результаты
Работник по субтитрам	Исправлять расшифровку и создавать субтитры, используя известный словарь
Работник по графике	Создавайте запрашиваемую графику движения в соответствии с согласованными сроками
Другие работники	Обрабатывайте отдельно назначенную музыку, анализ тишины или материалы для вступления и завершения
Механизм управления	Передавайте задачи нужному работнику и возвращайте его статус и результат

Отдельные панели терминала — это способ работы с этой установкой. Они не обеспечивают автоматическое расписание, общую память или надежный протокол передачи. Официальный сайт Pi описывает продукт с намеренно расширяемой архитектурой и не обещает встроенную оркестрацию суб-агентов. Выберите механизм управления после того, как узнаете, какие сообщения и файлы ему нужно передавать. Обзор Pi.

Прежде чем начать: установите Pi и убедитесь, что первый работник может прочитать свою задачу

Вам нужен терминал, рабочая папка, содержащая копии вашего тестового материала, и доступ к поддерживаемому поставщику моделей. Для описанного ниже пути через npm текущий быстрый старт Pi требует Node.js версии 22.19 или новее.

node --version
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version

Используйте отдельную папку для эксперимента. Перейдите в эту папку и запустите Pi:

pi

Внутри Pi введите /login и следуйте инструкциям для вашего поставщика. Используйте /model чтобы выбрать доступную модель. Ожидаемый результат — интерактивная сессия с вашей рабочей папкой и моделью, видимыми в интерфейсе. Начните с запроса только для чтения, например: «Перечислите файлы в этой папке и определите ввод заголовка. Пока ничего не редактируйте.»

Быстрый старт Pi сообщает, что он отображает чтения, команды и редактирования, которые он выполняет, и не спрашивает перед каждым вызовом инструмента. Используйте копии ценных исходных файлов для этого испытания. Эти шаги установки и входа в систему следуют за быстрому старту Anthropic; для этой статьи запуск редактирования в производственной среде не выполнялся.

Дайте работнику небольшое, явное задание

Создайте AGENTS.md в папке работника. Pi обнаруживает файлы контекста в рабочем каталоге и его родительских каталогах, а также в каталоге своего агента. Избегайте размещения правил только для подписей в глобальном файле, который влияет на несвязанные проекты. После редактирования инструкций во время работы Pi используйте /reload. Эти местоположения и поведение при перезагрузке задокументированы в конфигурации Pi.

Следующий файл является примерным инструкционным файлом для упражнения по субтитрам, а не встроенным пресетом Pi:

Вы отвечаете за исправление субтитров для этого проекта.

Прочитайте предоставленную расшифровку и глоссарий перед редактированием.
Сохраняйте порядок и тайминг меток, если задание явно не требует перенастройки времени.
Исправляйте название продукта только тогда, когда это подтверждается окружающей речью.
Сохраняйте сомнительные слова в списке для проверки с указанием номера метки.
Сохраняйте новый исправленный файл; исходный файл сохраняйте без изменений.
Сообщите путь к файлу вывода, внесённые изменения и нерешённые слова.
Не редактируйте графику, музыку или финальное видео.

Вносите подтверждённые имена в небольшой glossary.md рядом с этим. Для смешанных кантонского и английского записей Лео «Pi Durable» является конкретным примером имени, которое может появиться неправильно при транскрипции. Сохраните предполагаемое написание и достаточно контекста для его уточнения. Глоссарий не должен превращать любое подобное звучание в название продукта.

Дайте работнику задание, которое определяет имена файлов и предел его ответственности:

Прочтите AGENTS.md и glossary.md. Проверьте source.srt на наличие ошибок в названиях продуктов.
Напишите corrected.srt и review-notes.md. Сохраните время и порядок подсказок.
В заметках укажите каждую изменённую подсказку и каждое неопределённое слово.
Не изменяйте source.srt и не создавайте финальное видео.

Полезным результатом является исправленный файл плюс обозримый отчет о внесенных изменениях. Проверьте образец по аудиозаписи, особенно незнакомые имена и фразы на смешанных языках. Грамотно построенное предложение все еще может быть неправильной транскрипцией. Если во входных данных отсутствует аудио, необходимое для определения слова, работник должен оставить этот вопрос открытым, а не догадываться.

Это упражнение изолирует исправление текста. Распознавание речи, синхронизация субтитров и наложение субтитров на видео — это отдельные задачи с собственными инструментами; установка Pi не обеспечивает проверенную медиапайплайн.

Сохраняйте знания, не храня каждую старую беседу

Продолжающему специалисту необходим доступ к надежным рабочим знаниям. Не требуется бесконечно растущая переписка.

Сохраняйте подтверждённую лексику в глоссарии, повторяемую процедуру в инструкциях, а временные вопросы — в заметках текущей работы. После проверки результатов обновляйте глоссарий с учётом исправлений, которые должны применяться в следующий раз. Не превращайте непроверённое предположение в постоянное правило.

По умолчанию Pi автоматически сохраняет сессии. Из той же рабочей папки, pi --continue открывает последнюю сессию; pi --resume открывает выборщик. В активной сессии, /resume выбирает сохранённую сессию и /new начинает другую. /session показывает детали текущей сессии. Используйте эти элементы управления, чтобы убедиться, что вы возвращаетесь к нужной работе. Сессии и контекст Pi.

Сохраненный разговор и файл с инструкциями решают разные задачи. Разговор объясняет, что произошло на конкретной задаче. Файл указывает, что должно применяться к будущим задачам. Новый разговор все еще может извлечь пользу из глоссария и инструкций, а возобновленный разговор все еще может запутаться из-за устаревших решений.

Предпочтение Лео к постоянным рабочим связано с повторной корректировкой одного и того же словаря. Его противопоставление одноразовым субагентам описывает рабочие процессы, которые использовали он и Майкл; это не утверждает, что другая система не может сохранять навыки или память. Сохраняйте полезную информацию намеренно, независимо от того, как долго процесс рабочего остается открытым.

Когда процедура становится значительной, перенесите ее в навык. Навыки Pi используют каталог, содержащий SKILL.md с именем и описанием. Pi рекламирует описания навыков и читает полные инструкции при необходимости; /skill:name может явно вызывать его. Это позволяет сохранять подробные указания по созданию подписей без необходимости копировать их в каждый запрос. Следуйте официальный формат навыков <<<S1033286_0>>> при внесении этого изменения.

Разделите полный монтаж с учетом реальных зависимостей.

Для первого монтажа позвольте координатору пройти весь процесс и задокументировать принятую процедуру. В исходном примере это включает анимации и версию длиной одну минуту. Только после успешного выполнения можно превращать стабильные части в задания для работников.

Используйте подобный лист заданий для следующей записи. Имена файлов являются иллюстративной условностью, которую вы можете адаптировать.

Работа	Ввод	Результат	Что должно быть согласовано в первую очередь
Коррекция субтитров	Транскрипт, аудио, глоссарий	Исправленные субтитры и заметки о нерешённых словах	Ссылаются ли временные коды на исходный или смонтированный материал
Анализ пауз	Оригинальная запись	Предлагаемые вырезки с таймкодами	Какие паузы считаются намеренными
Моушн-графика	Краткое описание, утверждённый текст, ссылки на стиль	Графические материалы или проект для рендеринга	Точность текста и целевое время
Фоновая музыка	Редактировать краткое описание и доступные лицензированные треки	Выбор и размещение заметок	Тон, слышимость речи и права
Вступление и заключение	Активы бренда и запрашиваемое завершение	Подготовленные материалы	Продолжительность и формат
Сборка	Принятые результаты	Просмотр экспорта и финальный экспорт	Версия временной шкалы и оставшиеся решения по обзору

Коррекция субтитров и подготовка графики могут происходить одновременно. Окончательное время субтитров нельзя считать установленным, пока другой работник изменяет временную шкалу монтажа. Попросите координатора разрешить эту зависимость перед сборкой.

Практическая передача должна указывать исходную версию, путь вывода, выполненные проверки и незавершенные решения. «Готово» слишком расплывчато. «Исправлены 12 меток названий продуктов; метка 84 все еще требует аудиопроверки; тайминг не изменен; файл вывода в corrected.srt» дает координатору конкретную информацию для работы. Это пример отчета, а не результат, измеренный для данного руководства.

Предоставьте каждому работнику ответственность за его выходные файлы. Если два работника редактируют одну и ту же временную линию, координатор должен разрешать конкурирующие изменения, а также проверять их качество. Независимые ресурсы и явные точки интеграции проще проверять.

Держите контекст координации сосредоточенным

Координатору нужен полный креативный бриф и текущее состояние редактирования. Обычно не требуется предоставлять каждую неудачную попытку графики или каждую строку вывода субтитрового инструмента. Попросите работников предоставлять краткие результаты и пути к файлам, а подробные журналы — только когда возникает проблема, требующая их.

Это практический ответ на проблему контекста, которую описывает Лео. Майкл называет насыщенный контекст «зоной тупости» и предлагает примерно 60 процентов использования в качестве эмпирического правила. Этот процент не был установлен контролируемым тестом и не должен становиться универсальным порогом для перезапуска.

Pi показывает использование контекста и обычно сжимает более старую историю близко к пределу модели. /compact запрашивает сжатие вручную; исходные записи сеанса остаются сохранёнными. Сводка помогает уместить разговор, но всё равно стоит сохранять явные решения и результаты вне чата. Управление сеансами Pi.

Разделение агентов также имеет свои издержки. Каждому работнику нужен достаточный контекст, чтобы избежать неправильной интерпретации, а координатор должен проверять возвращённую работу. Параллельное выполнение помогает только там, где задания могут выполняться независимо и машина может их поддерживать. Несколько одновременных рендеров могут конкурировать за одно и то же оборудование.

Добавляйте пакеты только для конкретного отсутствующего поведения

Отсутствие правила повторной попытки, команды состояния или функции оркестрации является причиной для проверки расширения. Большой каталог не является причиной устанавливать несколько пакетов до того, как первый рабочий модуль выполнится успешно.

Пакеты Pi включают расширения, навыки, подсказки и темы. Официальное руководство по пакетам документирует установку через npm, git и локальные директории; pi list показывает настроенные пакеты. Местные объявления проекта используют --local, и пакеты проекта загружаются после предоставления доверия. Проверьте исходный код и выберите явную версию перед добавлением исполняемых расширений. Управление пакетами Pi.

Пакетный тур Лео поддерживает идею выбора собственного поведения, но он не определяет полный проверенный стек расширений. Нет надежного способа одним командным запуском воспроизвести всю его настройку из исходного кода. Начните с указания того, что необходимо координатору: как отправлять задания, идентифицировать рабочего, проверять статус, собирать результат и восстанавливаться после прерывания. Затем выберите механизм, который на самом деле поддерживает эти операции.

Устраните неполадки первого рабочего, прежде чем добавлять другого.

Если рабочий останавливается раньше времени, уменьшите задачу до выполнимой им части и явно укажите отсутствующее условие. Лео отмечает, что Пи менее склонен выполнять длинные и разнообразные задачи без направления, поэтому он предпочитает, чтобы способный координатор управлял процессом. Это его опыт, а не гарантия того, что добавление цикла решит каждую незавершённую задачу.

Если оно забывает исправление, проверьте, какая рабочая папка и сессия активны, содержит ли глоссарий подтверждённое написание и действительно ли задача требовала обращения к этому файлу. Если навык был пропущен, вызовите его явно. Если результаты не совпадают, сравните исходную версию и ответственность, назначенную каждому рабочему, перед изменением модели.

Более дешёвая модель может подойти для узкой задачи создания подписей, но протестируйте её на тех именах и языках, которые вы реально используете. Считайте исправления и время на проверку, а не только цену за токен. Майкл сообщает, что его последовательный процесс редактирования занял около трёх–четырёх часов. Он также мимоходом вспоминает, что видел, как Лео создавал примерно шесть видео за час, но эти работы не сопоставлялись с его собственным редактированием. Ни одна из оценок не является контролируемым сравнением пропускной способности, и исходные данные не предоставляют учёта затрат, подтверждающего экономию Pi.

Для вашей следующей записи повторите упражнение с субтитрами, используя принятый глоссарий и новый исходный файл. Сохраняйте работника только если он повторно использует полезные правила, создает проверяемые файлы и сокращает работу после проверки. Как только это удастся, дайте координатору второе независимое задание. Удаленное планирование и восстановление — это отдельный уровень, описанный в Руководстве по долговечным рабочим процессам Pi..