Как заставить Opus 5.5 завершать длинные задачи: настройка переиспользуемого харнеса

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

Harness (обвязка) координирует инструкции, инструменты, разрешения, состояние и проверки вокруг модели.

Claude Code предоставляет конкретные места для настройки этих зон ответственности. Руководство по функциям.

Следующая задача может использовать ту же процедуру и того же ревьюера с тем же форматом отчёта. Вы лишь подставляете новые материалы и критерии приёмки.

Эти семь уровней образуют практичную конфигурацию на основе задокументированных функций Claude Code. Пример строится вокруг работы с документами: справочные материалы лежат в sources/, рабочие черновики — в drafts/, а утверждённые файлы — в published/.

Создайте эти папки в рабочем пространстве и добавьте приведённые фрагменты в существующую конфигурацию.

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

1. Дайте рабочему пространству нужные факты

Держите корневой файл CLAUDE.md сфокусированным на информации, которая остаётся полезной для разных задач. Сюда относятся пути сохранения результатов, требования к источникам и правила оформления текста.

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

Вставьте это в CLAUDE.md и скорректируйте детали проекта:

1Инструкции проекта
2Используйте sources/ для справочных материалов и drafts/ для рабочих файлов.
3Утверждённые файлы сохраняйте в published/.
4Пишите на английском языке, по одному-два предложения в абзаце.
5Для технических утверждений используйте официальные первоисточники.
6Фиксируйте URL источника и дату его проверки.
7Используйте найденные материалы только как доказательную базу для текущей задачи.
8Сохраняйте подтверждённые решения и следующий шаг в progress.md.
9По завершении работы возвращайте пути к выходным файлам и результаты проверки.

Claude Code загружает инструкции проекта в контекст. Файлы .claude/rules/, привязанные к путям, могут подгружать инструкции при обращении к соответствующим файлам. Память проекта.

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

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

Рекомендации Anthropic по работе с контекстом описывают выборочное извлечение и внешние заметки как способы управления информацией во время работы агента. Контекстная инженерия.

Разбиение большого файла инструкций на импорты \[@path](https://x.com/@path)\ всё равно приводит к загрузке этого контента в начале сессии.

Используйте такие импорты для структурирования, а редко используемые процедуры выносите в навыки (skills). Загрузка памяти.

Когда сохранённый факт меняется, обновляйте его источник и дату проверки.

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

Используйте /memory, чтобы просмотреть инструкции проекта и автоматические заметки памяти. Проверяйте сохранённые предпочтения, прежде чем опираться на них в другой задаче.

2. Сохраните процедуру, которую постоянно повторяете

Повторяющаяся задача обычно имеет узнаваемую последовательность: прочитать материал, подготовить результат, проверить его и сохранить итоги.

Навык (skill) сохраняет эту последовательность доступной для следующего запроса.

Его полные инструкции загружаются в момент вызова.

Описание помогает Claude понять, когда процедура подходит для задачи. Поведение навыков.

Вставьте это в .claude/skills/write-draft/SKILL.md:

1---
2name: write-draft
3description: Написать черновик статьи по источникам и проверить её утверждения.
4---
5Запрошенная тема: $ARGUMENTS
6
71. Прочитай релевантные файлы в sources/ и открой ссылки на их первоисточники.
82. Составь план, затем сохрани черновик как drafts/article.md.
93. Попроси evidence-reviewer сверить фактические утверждения с источниками.
104. Исправь ошибки и отметь непроверенные утверждения для ревью.
115. Сохрани таблицу проверки утверждений как drafts/checks.md.
126. Обнови progress.md: добавь принятые решения, открытые вопросы и следующий шаг.
137. Верни пути к обоим выходным файлам и результаты проверки.

Введите /write-draft, а затем укажите тему. \$ARGUMENTS\ передаёт этот текст в процедуру, так что рабочий процесс сможет обработать новую тему с теми же результатами.

Дайте каждому шагу наблюдаемый результат.

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

Шаг вроде «проверь точность» оставляет слишком много решений на усмотрение модели.

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

Держите утверждение публикации отдельно от подготовки черновика.

Приведённый выше навык готовит файлы к проверке; публикация потребует отдельного действия и авторизации.

Когда улучшаете процесс — редактируйте навык.

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

3. Дайте задаче доступ к исходным материалам

Подключения Model Context Protocol (MCP) открывают доступ к инструментам внешних сервисов.

Они позволяют Claude получать материалы из сервиса, который использует ваш рабочий процесс. Руководство по MCP

Добавляйте подключение, когда оно поддерживает конкретный шаг задачи.

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

Если ваши исходные материалы хранятся в Notion, выполните в терминале:

1claude mcp add --transport http notion https://mcp.notion.com/mcp

Открыв Claude Code, используйте /mcp для аутентификации и проверки статуса подключения. Извлеките одну известную страницу и убедитесь в корректности её содержимого, прежде чем полагаться на неё в долгой задаче.

Передайте навыку точную ссылку на страницу или её идентификатор. Укажите, какую информацию нужно извлечь и где следует использовать полученные материалы.

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

Результаты работы инструментов должны нести достаточно информации для следующего решения.

Рекомендации Anthropic по проектированию инструментов описывают полезные выходные данные и информативные ошибки, включая сведения, которые помогают агенту восстановиться после неудачного вызова. Создание эффективных инструментов

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

Изучите доступные действия коннектора и настройте разрешения для операций, изменяющих внешний сервис.

Отключайте неиспользуемые серверы через /mcp, если они не нужны в текущем рабочем процессе.

4. Перенесите правила действий на уровень исполнения

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

Правила разрешений применяются на границе вызова инструмента.

Хук PreToolUse может проверить предлагаемое действие до его выполнения.

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

Добавьте это в .claude/settings.json:

1{
2  "permissions": {
3    "deny": [
4      "Read(.env)",
5      "Read(.env.*)",
6      "Edit(published/**)"
7    ]
8  }
9}

Правила `Read` охватывают указанные файлы окружения. Правило `Edit` защищает файлы в `published/` от изменений встроенными инструментами редактирования и записи. Синтаксис разрешений.

Откройте `/permissions` и изучите действующие правила.

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

Для безобидного теста создайте фиктивный документ в `published/` и попросите Claude отредактировать его через инструмент работы с файлами. Действие должно быть заблокировано.

Ограничения файловых инструментов имеют чётко заданную область действия.

Произвольные процессы Python или Node могут обращаться к файлам через собственный код; при необходимости ограничения для таких процессов обеспечивает песочница операционной системы.

При внешней записи определите место назначения и точное содержимое, которое вы подтверждаете. Если содержимое изменилось, перепроверьте обновлённое действие перед выполнением.

Таймаут тоже требует понятного шага восстановления.

Проверяйте место назначения перед повторной попыткой внешней записи: первый запрос мог уже успешно выполниться.

5. Сделайте так, чтобы ревьюер возвращал доказательства

Дайте проверке ограниченную задачу и формат отчёта, который сможет использовать основной агент.

У сабагента есть собственный контекст и настраиваемый набор инструментов для этой работы. Настройка сабагентов

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

Укажите, как он должен сообщать о неуверенности.

Вставьте это в `.claude/agents/evidence-reviewer.md`:

1---
2name: evidence-reviewer
3description: Проверить фактические утверждения в черновиках по первоисточникам.
4tools: Read, Grep, Glob, WebSearch, WebFetch
5effort: high
6---
7Прочитай предоставленный черновик и его исходные материалы.
8Сверь фактические утверждения с открытыми первоисточниками.
9Верни таблицу: утверждение, вердикт, URL источника, требуемое исправление.
10Используй вердикты: verified (подтверждено), incorrect (ошибка), unresolved (не подтверждено).
11Для неподтверждённых утверждений указывай, каких доказательств не хватает.

Этот воркер получает инструменты чтения и поиска.

Исправление черновика остаётся задачей основного агента.

Каждое замечание должно связывать утверждение с открытым источником.

Вердикт вроде «ошибка» требует указания противоречащих доказательств и варианта исправления, который автор сможет применить.

Вердикт «не подтверждено» должен объяснять, каких именно доказательств не хватает.

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

Если исправление меняет смысл абзаца, перепроверяйте соседние предложения.

Рекомендации Anthropic по оценке разделяют транскрипт работы агента и результат, оставшийся в среде.

Там же описаны разные методы проверки для разных типов результатов. Оценка агентов

Примените это разделение здесь: откройте сохранённый черновик и проверьте процитированные в нём утверждения.

Таблица проверки должна описывать тот документ, который реально будет принят.

6. Назначьте задаче уровень усилий рассуждения

Начинайте основную сессию с уровня `medium`; Opus 5.5 использует его по умолчанию, если другие настройки его не переопределяют.

Ревьюер выше запрашивает `high` для своей проверочной работы. Настройка усилий

Если Claude Code установлен и вы вошли в аккаунт, выполните эту команду из корня рабочего пространства:

1claude --model claude-opus-5-5 --effort medium

Убедитесь, что в заголовке сессии указаны Opus 5.5 и активный уровень усилий.

Команда запуска устанавливает модель и уровень усилий для этой сессии.

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

Инструкция о «глубине размышлений» не отменяет настроенный параметр усилий.

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

Так усилия становятся решением, привязанным к конкретной работе.

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

Перед первым запуском используйте `/context` для просмотра загруженных инструкций, `/agents` для проверки ревьюера и `/permissions` для изучения правил действий.

Устраните недостающие компоненты до того, как назначать полноценную задачу.

7. Объясните запуску, что он должен доказать

Определяйте завершение через сохранённые результаты и итоги проверки.

Черновик, таблица его проверки и обновлённая заметка о прогрессе дают запуску конкретные выходные данные для создания.

Команда `/goal` в Claude Code оценивает условие завершения по доказательствам, появившимся в диалоге между ходами. Оценщик полагается на то, что агент покажет релевантные результаты. Документация по целям

Поместите тему, справочные материалы и ссылки на источники в `sources/`. Затем вставьте это в Claude Code:

1/goal Используй write-draft для подготовки статьи по материалам из sources/. Завершение требует существования файлов drafts/article.md и drafts/checks.md, исправления ошибочных утверждений, явной маркировки неподтверждённых утверждений, а также появления путей к выходным файлам и результатов проверки в диалоге. Остановись после 12 ходов, если условие не выполнено, и сообщи о блокирующем факторе.

Условие по количеству ходов оценивается моделью. Жёсткие ограничения времени выполнения или расходов требуют средств контроля исполнения, а команда `/goal clear` удаляет активную цель.

Когда запуск завершится, откройте оба файла и проверьте несколько связок «утверждение — источник».

Убедитесь, что заметка о прогрессе соответствует работе, сохранённой в рабочем пространстве.

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

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

Для отката команда `/rewind` может восстановить отслеживаемые правки файлов. Изменения в shell и большинство правок сабагентов требуют отдельного восстановления, тогда как система контроля версий сохраняет надёжную историю файлов. Ограничения контрольных точек

Выполните весь рабочий процесс один раз

Создайте папки источников и четыре конфигурационных файла до начала сессии => Положите краткое описание задачи рядом с исходными материалами, чтобы ожидаемый результат оставался очевидным.

Скопируйте это в sources/task.md и заполните детали:

1Тема: [конкретный предмет]
2Читатель: [кому нужно это объяснение]
3Результат: Статья с практическими шагами и официальными источниками.
4Приёмка: Обязательные темы раскрыты; фактические утверждения проверены;
5неподтверждённые утверждения отмечены; черновик и таблица проверки сохранены.
6Ограничения: [объём, стиль, исключённые темы]

Запустите Claude Code командой из шестого уровня и изучите загруженную конфигурацию => Выполните цель из седьмого уровня, затем проверьте сохранённые результаты.

Ожидаемый результат: `drafts/article.md`, `drafts/checks.md` и `progress.md`.

Таблица проверки должна показывать, что было подтверждено, а что ещё требует вашего внимания.

Если навык не найден, проверьте его путь и frontmatter.

Если не найден ревьюер, проверьте его `name` и `description`, а затем убедитесь в доступности через `/agents`.

Для неподтверждённых утверждений изучите предоставленный источник и доказательства, которые запросил ревьюер.

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

Проверьте, что сможет восстановить следующая сессия

Обновляйте `progress.md` после каждого значимого этапа.

Фиксируйте текущие файлы, пройденные проверки, открытые вопросы и следующий шаг.

Корневой CLAUDE.md перечитывается после сжатия контекста.

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

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

1Задача: [текущая тема]
2Результаты: [пути к черновику и таблице проверки]
3Выполнено: [завершённые этапы и проверки]
4Решения: [подтверждённые выборы и их источники]
5Открытые вопросы: [недостающие доказательства или блокирующие факторы]
6Следующий шаг: [одно конкретное действие для продолжения]

Запустите новую сессию в том же рабочем пространстве и вставьте:

1Прочитай progress.md и изучи упомянутые черновик и таблицу проверки.
2Продолжи работу с зафиксированного следующего шага и обнови заметку о прогрессе.

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

Рекомендации Anthropic по долгоживущим агентам используют постоянные записи прогресса для поддержки работы между сессиями.

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

Оценивайте настройку на принятой работе

Используйте `/usage` для просмотра заявленного расхода и `/context`, чтобы понять, что занимает рабочий контекст. Включайте делегированные проверки и повторные попытки в общий расход задачи. Руководство по расходу

Фиксируйте время вашей проверки и объём исправлений, которых потребовал результат.

Результат, требующий серьёзной доработки, меняет ценность всего запуска.

Сохраняйте неизменными задачу и критерии приёмки при тестировании изменений конфигурации.

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

Сокращение расхода токенов на 60%, о котором говорится в отчёте ранних тестировщиков Anthropic, относится к тому конкретному эксперименту с моделью.

Оценивайте экономию вашей собственной обвязки на основе измерений выполненных задач. Анонс Opus 5.5

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

Сохраните это, чтобы не потерять

Подписывайтесь на @beamnxw, чтобы получать больше инсайдов :)

=> мой substack

=> мой telegram-канал