Як змусити 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)\ все одно завантажує цей вміст на початку сесії.

Використовуйте такі імпорти для структурування, а окремі процедури виносьте у скіли. Завантаження пам'яті.

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

Уподобання, виявлене під час однієї чернетки, стає постійним правилом лише після того, як ви підтвердите, що воно має діяти й у майбутніх чернетках.

Використовуйте /memory, щоб переглянути інструкції проєкту та нотатки автопам'яті. Перевіряйте збережені вподобання, перш ніж спиратися на них в іншому завданні.

2. Збережіть процедуру, яку постійно повторюєте

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

Скіл зберігає цю послідовність доступною для наступного запиту.

Його повні інструкції завантажуються під час виклику.

Опис допомагає 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Для нерозв'язаних тверджень вкажи, яких доказів бракує.

Цей воркер отримує інструменти читання та пошуку.

Виправлення чернетки залишаються за основним агентом.

Кожен висновок має пов'язувати твердження з відкритим джерелом.

Вердикт на кшталт «incorrect» потребує суперечливих доказів і виправлення, яке автор зможе застосувати.

Вердикт «unresolved» має вказувати на відсутні докази.

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

Якщо виправлення змінює сенс абзацу, перечитайте сусідні речення.

Рекомендації 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` може повернути відстежені редагування файлів. Зміни в оболонці та більшість редагувань субагентів потребують окремого відновлення, тоді як система контролю версій зберігає довговічну історію файлів. Обмеження контрольних точок

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

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

Скопіюйте це у 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 перечитується після стиснення (compaction).

Інструкції з обмеженою областю дії перезавантажуються під час доступу до відповідних файлів. Стиснення та пам'ять

Використовуйте цю компактну структуру для нотатки про прогрес:

1Завдання: [поточна тема]
2Результати: [шляхи до чернетки та звіту]
3Виконано: [завершені етапи та перевірки]
4Рішення: [підтверджені вибори та їхні джерела]
5Відкриті питання: [відсутні докази або блокуючі фактори]
6Наступна дія: [один конкретний крок для продовження]

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

1Прочитай progress.md і переглянь згадані чернетку та перевірки.
2Продовжуй із записаної наступної дії та онови нотатку про прогрес.

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

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

Оновлюйте ці записи в міру зміни завдання, щоб відновлений запуск мав актуальну інформацію. Обв'язки для довготривалих агентів

Оцініть налаштування на прийнятій роботі

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

Фіксуйте час своєї перевірки та виправлення, яких потребував результат.

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

Тримайте завдання та критерії приймання незмінними під час тестування зміни конфігурації.

Змініть один компонент, повторіть завдання та перевірте і збережений результат, і його докази.

Зменшення використання токенів на 60%, про яке йдеться у звіті ранніх тестувальників Anthropic, стосується саме того експерименту з моделлю.

Визначайте економію власної обв'язки через вимірювання завершених завдань. Анонс Opus 5.5

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

Збережіть це, щоб не загубити

Підписуйтесь на @beamnxw, щоб отримувати більше інсайдів :)

=> мій substack

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