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 настраивает модели по ролям.
Не путайте несколько ответов с независимой проверкой. Если все исполнители получили одну ошибочную предпосылку, они могут согласиться друг с другом. Нужны проверяемые основания: запуск, тест, результат в интерфейсе, измерение. Если среда не позволяет выполнить обязательный этап, это ограничение должно попасть в итоговый отчёт.
Как правильно поставить первую задачу
Полезный запрос содержит пять вещей:
- Цель: что сломано или какое поведение нужно получить.
- Исходные данные: шаги воспроизведения, файл, лог, утверждённое требование.
- Критерий готовности: проверка, которая может пройти или не пройти.
- Доказательство: какой вывод команды, результат в интерфейсе или число вы хотите увидеть.
- Границы: что можно менять, где нужно остановиться и какие действия запрещены.
Промпт:
Используй 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.
По заявлению сопровождающего в 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 в рабочий проект
После учебного запуска выберите одну реальную задачу с понятной проверкой. Не начинайте с поручения «перепиши весь проект».
- Запишите исходную ошибку или требование и сохраните состояние проекта без потери текущих правок.
- Ограничьте доступы, число исполнителей и действия с коммитами, PR и выпуском.
- Попросите Poteto Mode выбрать сценарий. Проверьте цель и критерий готовности до записи кода.
- Примите результат по фактическим проверкам, включая пропущенные этапы и недоступные источники.
- Повторите цикл на нескольких сопоставимых задачах и оцените качество, время и расход. Один удачный запуск не доказывает устойчивое улучшение.
Если агент повторяет одну ошибку, определите, что её надёжнее предотвращает: структура кода, типы, линтер, тест или инструкция. В исходном пакете correct работает с повторяющимися классами ошибок, а reflect предлагает изменения навыков по результатам сессии. Эти процедуры сами могут читать историю и предлагать запись: согласуйте область заранее. Подробности — в руководстве по адаптации pstack под себя.
Не редактируйте установленный пакет незаметно посреди реализации функции. Изменение навыка должно быть отдельным, обозримым решением с проверкой на прежних и новых задачах. Полезный итог внедрения — повторяемый процесс с известными границами, а не количество установленных инструкций.
Первичные источники
Исходный pstack Лаурен Тан — основа руководства
- Главная страница pstack: исходный пакет, навыки и документация.
- README оригинала: назначение, установка в Cursor и Claude Code.
- Полное руководство автора: от первого запуска до проверки результата.
- Poteto Mode: выбор сценария, принципы и организация работы.
- Рабочие сценарии оригинала: Bug fix, Investigation, Feature.
- Настройка исходного пакета: модели, бюджет и первый запуск.
- Адаптер оригинала для Claude Code: инструменты, модели и ограничения.
Отдельный перенос pstack-claude — для разделов об адаптациях
- Репозиторий Michael Denyer: pstack-claude.
- README переноса: установка и обработка данных.
- Справочник переноса: Codex, зависимости и поддержка сред.
- Настройка моделей и маршрутизации именно в переносе.
- Сопоставление инструментов и ограничения Codex в переносе.
- Реестр отличий переноса от оригинала.
Документация среды
Ссылки на файлы GitHub закреплены на ревизиях, указанных в начале материала: так можно проверить описанное поведение. Главные страницы обоих проектов ведут на актуальные версии; перед установкой сверяйте изменения.
Следующий шаг
Skills и Plugins в Codex App: установка, использование и создание своих — если нужно разобраться, чем пакет отличается от отдельного навыка и как проверять установленные возможности.
Связанные материалы
- Статья: Мои Codex skills: как мы собираем дисциплину для ИИ-агента.
- Блог: Poteto Mode: агент сначала проверяет, потом спрашивает.
- База знаний: Перенос скилла из Claude в Codex: пошаговое руководство. Если команда внедряет общие навыки для нескольких агентов, полезно заранее согласовать границы записи, проверки и расход моделей на одном небольшом проекте. Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov
