pstack — исходный пакет Лаурен Тан (poteto): набор навыков и рабочих сценариев для ИИ-агента, который пишет и проверяет код. Вы задаёте результат и условия готовности, а пакет описывает, как разобраться в задаче, выбрать подход, распределить работу и проверить изменение.

Руководство поможет понять устройство pstack, выбрать подходящую версию для Cursor, Claude Code или Codex и пройти первую задачу без передачи агенту лишних полномочий. Установка — один из этапов: пользоваться пакетом имеет смысл, когда вы понимаете, какой результат он должен предъявить.

Граница проверки. Общая часть и маршрут из исходного репозитория сверены 18 октября 2026 года, ревизия 4382e6. Технические особенности переноса pstack-claude разобраны по версии 0.9.90, ревизии 5bd4529, проверенной 17 октября. Учебный тест отдельно выполнен на Node.js 24.14.1: до исправления — два успешных теста и один неуспешный, после — три успешных. Установка пакетов, хуки и работа субагентов при подготовке руководства не запускались.

Зачем нужен pstack и когда его применять

При работе с кодинг-агентом результат часто приходится проверять отдельно: правильно ли понята ошибка, изучены ли вызывающие функции, не исчез ли тест вместе с проблемой. pstack задаёт процедуры для такой работы. В README исходного проекта Лаурен Тан, известная как poteto, формулирует ориентир: писать меньше кода и повышать его качество. Это цель пакета, не гарантия результата любого запуска.

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

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

Как связаны pstack, Poteto Mode и отдельные навыки

В системе удобно различать четыре слоя:

СлойЕго рольПример
Пакет pstackУстанавливаемый набор связанных инструкций и ресурсовНавыки, сценарии, справочные файлы и адаптация под среду
Poteto ModeГлавная точка входа, выбирающая порядок работыПо запросу об ошибке выбирает Bug fix
Сценарий, или playbookПоследовательность шагов для класса задачВоспроизвести ошибку, найти причину, исправить, проверить
Отдельный навык, или skillПроцедура для конкретного шагаhow объясняет устройство кода, architect помогает выбрать структуру изменения

Отдельно действуют принципы: как выбирать размер изменения, строить данные, проверять поведение и распределять работу. Они применяются по ситуации. Источник устройства — Poteto Mode.

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

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

Что происходит между запросом и готовым результатом

Схема ниже — общий ориентир, а не обещание одинаковой последовательности для всех задач.

flowchart TD
    A[Цель и критерий готовности] --> B[Poteto Mode выбирает сценарий]
    B --> C[Исследование и проверяемый план]
    C --> D{Разрешена реализация?}
    D -->|Нет| E[Объяснение и решение пользователя]
    D -->|Да| F[Изменение в согласованных границах]
    F --> G[Проверка на нужных данных и в нужной среде]
    G --> H[Отчёт с доказательствами и ограничениями]
    G -->|Проверка не пройдена| C

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

Задача пользователяПодходящий сценарийЧем подтверждается результат
Понять незнакомую подсистемуInvestigationСсылками на изученный код и обозначенными пробелами
Исправить известный дефектBug fixВоспроизведением до изменения и той же проверкой после
Добавить поведениеFeatureСогласованными требованиями и проверкой нового сценария
Изменить структуру, сохранив поведениеRefactoringПроверками прежнего контракта
Устранить измеренную медленную работуPerf issueСопоставимыми измерениями до и после
Проверить спорную идею дёшевоPrototypeНебольшим экспериментом, позволяющим принять решение

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

Что делают исследователь, исполнитель и проверяющий

Главный агент ведёт задачу и отвечает за итог. Он может поручать ограниченные участки субагентам — отдельным исполнителям со своим контекстом. Единого числа участников на каждый запрос нет: состав зависит от сценария, настроек и возможностей среды. При этом в исходных сценариях Bug fix и Feature делегирование реализации предусмотрено явно. Минимальная конфигурация не даёт основания молча убирать обязательный этап: если среда его не поддерживает, укажите ограничение и согласуйте другой порядок работы.

  • how / why помогают понять устройство и основания прежних решений. Ответ зависит от доступного кода, истории и подключённых источников.
  • architect помогает сравнить варианты устройства изменения до реализации.
  • arena организует конкурирующие попытки решения одной задачи; swarm распределяет работу по участкам или организует несколько исполнителей для выбранной проверки.
  • interrogate использует разные модели, чтобы оспорить решение или найти проблемы в изменении.
  • poteto-help объясняет, какой сценарий или навык подходит; setup-pstack настраивает модели по ролям.

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

Как правильно поставить первую задачу

Полезный запрос содержит пять вещей:

  1. Цель: что сломано или какое поведение нужно получить.
  2. Исходные данные: шаги воспроизведения, файл, лог, утверждённое требование.
  3. Критерий готовности: проверка, которая может пройти или не пройти.
  4. Доказательство: какой вывод команды, результат в интерфейсе или число вы хотите увидеть.
  5. Границы: что можно менять, где нужно остановиться и какие действия запрещены.

Промпт:

Используй poteto-mode для новой задачи в этом репозитории.

Проблема: при экспорте отфильтрованного списка теряется последняя запись. Шаги воспроизведения и разрешённый набор тестовых данных я передам следующим сообщением.

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

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

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

В конце покажи diff, выполненные проверки, пропущенные этапы и оставшиеся ограничения.

В Cursor сначала выберите /poteto-mode из меню навыков, в Claude Code — /pstack:poteto-mode. В Codex используйте доступную запись установленного пакета или запрос по имени. Сам текст задачи остаётся применимым во всех трёх случаях; синтаксис вызова зависит от среды.

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

Какие правила pstack полезно применять осознанно

В принципах Poteto Mode есть несколько ориентиров, которые помогают оценивать работу агента:

ПринципЧто это меняет в задаче
Fix Root CausesИсправление должно объяснять механизм ошибки, а не скрывать симптом дополнительным условием
Prove It WorksСборка не заменяет проверку нужного пользовательского поведения
Test Behavior, Not ImplementationТест закрепляет наблюдаемый результат, а не случайное внутреннее устройство
Model the DomainПеред логикой нужно определить данные и допустимые состояния
Sequence Work into Verifiable UnitsБольшое изменение разбивается на части с проверкой каждой
Encode Lessons in StructureПовторяющуюся ошибку лучше блокировать типами, тестом или проверкой, чем бесконечно напоминать о ней в чате

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

Выберите исходный пакет или перенос

Исходный проект — pstack Лаурен Тан в репозитории cursor/plugins. Его руководство описывает устройство и рабочие сценарии пакета. pstack-claude Michael Denyer — отдельный перенос, а не главный репозиторий pstack. Для первой задачи выберите один источник и читайте документацию именно к нему.

Среда и источникКакой вариант здесь рассматриваетсяВажное отличие
Cursor, cursor/pluginsИсходный pstack Лаурен ТанИспользует возможности и имена инструментов Cursor
Claude Code, cursor/pluginsУстановка из исходного репозитория с адаптером Claude CodeСобственные правила настройки моделей и замены функций Cursor
Codex и другие среды, michael-denyer/pstack-claudeОтдельный перенос Michael DenyerАдаптация инструментов, собственные настройки и изменения политики

В README исходного пакета уже описана установка в Claude Code. Поэтому перенос Michael Denyer не является единственным маршрутом для этой среды. При этом наличие поддержки в документации не заменяет проверку конкретной установки.

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

Подготовьте безопасное место для первого запуска

Для начала нужны:

  • установленный и авторизованный Cursor, Claude Code или Codex с поддержкой выбранного способа установки;
  • Git с настроенными именем и адресом для локальных коммитов;
  • отдельная учебная папка без клиентских данных и секретов;
  • доступные модели и понимание расходов по вашему плану;
  • Node.js 20 или новее для учебного примера ниже. Это требование примера, а не универсальная зависимость pstack.
⚠️
pstack может поручать агенту выполнять команды, менять файлы, создавать коммиты и работать с PR — запросами на включение изменений в репозиторий. Для первого опыта ограничьте инструменты учебной папкой и исключите доступ к рабочим системам. Запрет в промпте полезен, но технически не блокирует инструмент. Не отключайте подтверждения опасных действий ради установки пакета. В исходном Poteto Mode также есть широкие установки на самостоятельные обратимые и внешние действия. До первого запуска явно ограничьте полномочия и права инструментов. Настройка моделей не является настройкой доступа.

По заявлению сопровождающего в README, у переноса pstack-claude нет собственного сервера и телеметрии. При этом прочитанные агентом данные, включая расшифровки сессий, передаются провайдеру модели. Локальное выполнение скриптов не означает локальную обработку всех данных. Для учебного исправления не нужны GitHub CLI, публикация репозитория или доступ к GitHub. В справочнике переноса отдельно указаны зависимости для других сценариев: например, GitHub CLI для работы с PR и Bun для некоторых комплектных скриптов. Устанавливайте их только для выбранной задачи.

Установка в Cursor, Claude Code и Codex

Это альтернативные маршруты. Выберите один под своего агента. Команды получают доступную в источнике версию, а не закрепляют ревизии, по которым написано руководство.

Cursor: исходный пакет

В чате Cursor выполните:

/add-plugin pstack

Затем запустите настройку:

/setup-pstack

Выберите доступные модели и бюджет рассуждения. Начните новую сессию и выберите /poteto-mode перед задачей. Для справочного вопроса используйте /poteto-help. Этот маршрут описан в инструкции исходного проекта.

Claude Code: установка из исходного репозитория

Внутри Claude Code выполните:

/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins

Вызов настройки:

/pstack:setup-pstack

Для задачи используйте /pstack:poteto-mode. У этой сборки есть адаптер Claude Code: он сопоставляет инструменты и модели и описывает, какие функции Cursor недоступны. Облачный агент Cursor не превращается в такую же облачную среду Claude Code только из-за установки навыка.

Claude Code: альтернативный перенос Michael Denyer

Если нужен именно pstack-claude из этого репозитория, вместо предыдущего источника используйте:

/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claude

Этот вариант описан в README переноса. Имена команд похожи, но настройки и поведение не обязаны совпадать со сборкой из cursor/plugins. Если уже установлен один вариант, сначала проверьте его источник и решите, нужен ли переход; не добавляйте второй поверх первого.

Codex: перенос pstack-claude

В терминале сначала проверьте версию и справку:

codex --version
codex plugin --help

В справочнике переноса команды ниже сопоставлены со справкой codex-cli 0.154.0-alpha.6.2. Это не установленная минимальная версия. Свежая нативная установка для того изменения документации автором не тестировалась.

Если ваша версия поддерживает соответствующие команды:

codex plugin marketplace add michael-denyer/pstack-claude
codex plugin add pstack@pstack-claude

Если plugin add отсутствует, остановитесь и сверьтесь с актуальным маршрутом OpenAI и доступным браузером плагинов. Не заменяйте команду догадкой и не правьте кеш пакета вручную.

Начните новую сессию. Запросите Poteto Mode по имени или выберите запись установленного пакета, например pstack:poteto-mode. Формы /poteto-mode и /setup-pstack в Codex требуют отдельных необязательных ярлыков: команды Claude Code нельзя просто скопировать в Codex.

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

Настройка моделей, бюджета и полномочий

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

Вызовите setup-pstack способом для своей среды и передайте условия.

Промпт:

Настрой pstack для первого ограниченного запуска. Сначала установи источник и версию пакета, прочитай его setup-pstack и адаптер текущей среды.

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

До записи покажи diff и дождись согласования. Сохрани исходные версии файлов, не стирай несвязанные инструкции. Автоматическую маршрутизацию в переносе pstack-claude пока выключи. Не создавай дополнительные навыки, коммиты, PR и внешние записи.

После записи перечитай настройки и сообщи, как они загрузятся в новой сессии.

Пути различаются по источнику пакета:

ВариантНастройки по умолчаниюЗагрузка
Cursor, исходный pstack~/.cursor/rules/pstack-models.mdcПравило моделей Cursor, новая сессия после настройки
Claude Code, исходный pstack~/.claude/rules/pstack-models.mdПравила Claude Code; не переносить строки в CLAUDE.md или AGENTS.md
Claude Code, перенос pstack-claude~/.claude/pstack-models.mdЯвное включение через @ в CLAUDE.md
Codex, перенос pstack-claude~/.codex/pstack-models.mdСтроки моделей и default effort — в AGENTS.md профиля; session hook читается хуком из отдельного файла

Источники: setup исходного пакета, адаптер Claude Code, setup переноса. В переносе пути меняются при заданных CLAUDE_CONFIG_DIR и CODEX_HOME.

Настройка может пересобрать файл моделей целиком: сохраните исходник и проверьте точные изменения до записи. В исходном setup каждый элемент списка панели соответствует отдельному субагенту. auto и inherit-parent означают наследование модели основного чата и сами по себе не гарантируют меньшую цену.

Автоматический вызов и субагенты в переносе

Перенос pstack-claude добавляет хук SessionStart — скрипт, передающий инструкцию выбирать Poteto Mode для подходящих задач. Выключение маршрутизации через setup-pstack не удаляет пакет. В Codex, если доступен /hooks, просмотрите определение и отдельно решите, доверять ли ему.

Документация OpenAI ограничивает поддержку lifecycle hooks вручную установленными плагинами настольной среды, а перенос описывает более широкий маршрут для Codex. Установку навыков и работу хука проверяйте раздельно. Для первой задачи достаточно явного вызова навыка.

Для субагентов в Codex перенос указывает настройку:

[features]
# Добавьте ключ в существующий раздел, не заменяя весь config.toml.
multi_agent = true

Это фрагмент существующего ~/.codex/config.toml, а не полный конфиг. Не создавайте второй раздел [features]; учитывайте CODEX_HOME, если он задан. Возможность и лимит параллельной работы зависят от вашей версии и среды.

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

Проверьте, что пакет обнаружен

Начните новую сессию в учебной папке и дайте короткое задание без записи файлов. Промпт:

Используй poteto-help. Покажи, где в установленном pstack находятся poteto-mode и сценарий Bug fix. Назови источник ответа и объясни порядок работы над одним багом. Ничего не меняй, не запускай проект и не создавай PR.

Если навыки недоступны, сообщи это прямо. Не восстанавливай их содержание по общим знаниям.

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

Полезные сценарии

Исправить баг и увидеть разницу до и после

Задача: научиться принимать исправление по одному и тому же тесту. На входе — учебная функция, которая считает число страниц каталога. При 21 записи и размере страницы 10 нужны три страницы; исходная функция возвращает две. Создайте новую пустую папку. Если имя уже занято, выберите другое. Следующие команды предназначены для обычной оболочки macOS или Linux; в Windows создайте те же два файла своим редактором.

mkdir pstack-pagination-practice &&
cd pstack-pagination-practice &&
git init

Создайте pagination.mjs:

export function pageCount(total, pageSize) {
  return Math.floor(total / pageSize);
}

Рядом создайте pagination.test.mjs:

import test from 'node:test';
import assert from 'node:assert/strict';
import { pageCount } from './pagination.mjs';

for (const [total, size, expected] of [[0, 10, 0], [20, 10, 2], [21, 10, 3]]) {
  test(`${total} items, page size ${size}: ${expected} pages`, () => {
    assert.equal(pageCount(total, size), expected);
  });
}

Запустите проверку:

node --test pagination.test.mjs

Ожидаемый результат исходника — три теста, два успешных и один неуспешный. Падает случай с 21 записью: получено 2, ожидалось 3; код завершения — 1. Если картина другая, сначала разберитесь с окружением и содержимым файлов. Сохраните учебную исходную точку локальным коммитом. Это позволит исполнителям, использующим отдельные рабочие деревья Git, опираться на существующую историю:

git add pagination.mjs pagination.test.mjs
git commit -m "Add pagination practice fixture"
git status --short

После коммита последняя команда не должна показывать изменений. Если Git требует имя или адрес автора, настройте их обычным для себя способом. Не продолжайте, пока исходная точка не сохранена. Откройте эту папку в агенте и передайте задание. Промпт:

Используй poteto-mode и сценарий Bug fix для учебного репозитория.

Ошибка: pageCount(21, 10) возвращает 2, ожидается 3. Разрешённый контракт: total — целое неотрицательное число, pageSize — целое положительное. Другие входы в этой задаче не рассматриваем.

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

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

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

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

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

Наблюдаемый результат: функция округляет число страниц вверх, тот же тест проходит во всех трёх случаях, код завершения — 0. Именно такая замена Math.floor на Math.ceil отдельно проверена при подготовке примера. Это проверка учебной логики; работу pstack на этом задании ещё нужно подтвердить в вашей среде. Ограничение: тест проверяет только оговорённый контракт функции. Он не доказывает исправность реального интерфейса пагинации. Для ошибки в браузере повторите исходные действия в том же приложении — одинаковые фильтры, переходы и данные до изменения и после него.

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

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

Используй poteto-mode для исследования возможности CSV-экспорта отфильтрованного списка заказов. Сейчас разрешено только чтение: код и настройки не меняй, команды изменения состояния не запускай, PR не создавай.

Найди, где формируется список и применяются фильтры, какие данные доступны и как проверяется право их видеть. Выбери навыки исследования по сценарию pstack. Если нужная история недоступна, отметь этот пробел.

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

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

Заверши рекомендацией и планом следующего шага. Реализацию через Feature или architect без отдельного согласования не начинай.

Наблюдаемый результат: ссылки на реальные модули, два сравнимых варианта, перечень нерешённых продуктовых вопросов и проверяемый план. В сценарии Investigation результатом служит объяснение или рекомендация без изменения кода. После принятия требований можно отдельно согласовать реализацию. Сценарий Feature включает исследование, проектирование, распределение работы и проверку на соответствующей поверхности. Границы записи, расходы и действия с PR нужно задать заново. Ограничение: если агент не видит конфигурацию доступа или серверную часть, он не может подтвердить безопасность экспорта одним чтением интерфейса. Такие пробелы должны остаться в отчёте.

Как принимать результат работы

Проверяйте артефакты, которые соответствуют задаче:

ЭтапЧто попросить показатьЧего недостаточно
ПониманиеВоспроизведение ошибки или ссылки на изученный кодПересказ названия задачи
ПланОбласть изменения, ограничения и критерии готовностиОбщий список «исследовать — исправить — проверить»
ВыполнениеDiff и объяснение каждого затронутого участкаСообщение «код обновлён»
ПроверкаКоманда, условия, фактический вывод до и послеУспешная сборка вместо проверки нужного поведения
ПередачаНепроверенное, пропущенные шаги и оставшиеся решенияОбещание, что ошибки исключены

Для UI-багов нужен повтор сценария в интерфейсе. Для ускорения — измерение в сопоставимых условиях. Нельзя переносить успех учебного теста на всё приложение.

Расходы и случаи, когда лучше ограничить процесс

Исходный pstack распространяется под MIT-лицензией. Работа моделей оплачивается или учитывается в лимитах вашего провайдера. Несколько исполнителей и проверяющих создают дополнительные обращения; повышенная глубина рассуждения тоже может увеличить расход. Единой цены запуска pstack в проверенных источниках нет. Для небольшой понятной правки полный параллельный разбор может оказаться избыточным. Начните с одного ограниченного задания и оцените, сколько полезных проверок получилось по отношению ко времени и расходам. Не запускайте автономный сценарий только потому, что он включён в пакет. Перенос pstack-claude имеет собственные правила для проектирования, изоляции исполнителей и выпуска изменений. Перед обновлением рабочего набора сверяйте установленную версию с реестром отличий и актуальной документацией. Версии исходного пакета и переноса обновляются независимо: записывайте источник и версию своей установки.

Если что-то не работает

СимптомЧто проверитьБезопасный следующий шаг
Codex не знает plugin addВерсию CLI и справку pluginИспользовать поддерживаемый маршрут установки; не угадывать команду
Навык не обнаруженУстановленный пакет, новую сессию, дубли ручной установкиЯвно запросить poteto-help и получить путь к файлу
Настройки сохранены, но модели прежниеПодключение файла или строк в инструкциях текущего профиляСравнить реальные пути и начать новую сессию
Сложные задачи не переходят в Poteto Mode автоматическиДоступность, доверие и настройку хука в вашей поверхностиВызывать навык по имени; автостарт не обязателен для первого теста
Модель или уровень рассуждения недоступныРеально доступные имена и настройку ролейПовторить setup-pstack без выдуманных идентификаторов
Нет слотов для новых субагентовВозможности среды и лимит потоковОстановить дальнейший запуск; отметить блокировку независимой проверки
Агент собирается коммитить или открыть PRОграничения задачи и выбранный сценарийОстановить внешнее действие и оставить результат локально
Тест зелёный, но ошибка остаётсяСовпадают ли поверхность, данные и действия с исходным воспроизведениемПовторить исходный сценарий, не принимать другой тест за доказательство

Для отключения автоматической маршрутизации в переносе pstack-claude попросите setup-pstack выключить session hook и проверьте результат в новой сессии. Для полного отключения пакета используйте управление плагинами вашей версии. Не удаляйте целиком AGENTS.md или CLAUDE.md: там могут быть несвязанные правила. Если возвращаете настройки, восстановите только собственные согласованные изменения, сохранив последующие правки других участников.

Как внедрять pstack в рабочий проект

После учебного запуска выберите одну реальную задачу с понятной проверкой. Не начинайте с поручения «перепиши весь проект».

  1. Запишите исходную ошибку или требование и сохраните состояние проекта без потери текущих правок.
  2. Ограничьте доступы, число исполнителей и действия с коммитами, PR и выпуском.
  3. Попросите Poteto Mode выбрать сценарий. Проверьте цель и критерий готовности до записи кода.
  4. Примите результат по фактическим проверкам, включая пропущенные этапы и недоступные источники.
  5. Повторите цикл на нескольких сопоставимых задачах и оцените качество, время и расход. Один удачный запуск не доказывает устойчивое улучшение.

Если агент повторяет одну ошибку, определите, что её надёжнее предотвращает: структура кода, типы, линтер, тест или инструкция. В исходном пакете correct работает с повторяющимися классами ошибок, а reflect предлагает изменения навыков по результатам сессии. Эти процедуры сами могут читать историю и предлагать запись: согласуйте область заранее. Подробности — в руководстве по адаптации pstack под себя.

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

Первичные источники

Исходный pstack Лаурен Тан — основа руководства

Отдельный перенос pstack-claude — для разделов об адаптациях

Документация среды

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

Следующий шаг

Skills и Plugins в Codex App: установка, использование и создание своих — если нужно разобраться, чем пакет отличается от отдельного навыка и как проверять установленные возможности.

Связанные материалы