pstack — набор навыков и 24 инженерных принципа для строгой работы с ИИ-агентами
📂 Исходный код на GitHubЗеркало плагина cursor/plugins/pstack: почти 60 agent skills для строгой инженерии с ИИ-агентами — диспетчер poteto-mode с 23 плейбуками, 24 принципа кодирования, субагенты и мульти-модельные рабочие процессы. Работает в Claude Code, Codex, Pi, Cursor и OpenCode.
pstack — это коллекция агентных навыков (Agent Skills) от разработчика с ником Потето (Poteto). За плечами у автора — миллионы строк кода в Meta и Netflix, работа в Cursor и участие в команде ядра React, где он помогает поддерживать React Compiler. Формально репозиторий — это зеркало плагина cursor/plugins/pstack, вынесенное в отдельный проект, чтобы навыками можно было пользоваться без Cursor — в любом агенте.
Проект отвечает на простую жалобу: ИИ-ассистенты пишут слишком много низкокачественного кода. Потето согласен с этим мнением и предлагает обратный подход: цель — не максимум строк, а меньше кода и выше качество. Отсюда и главный эффект набора, который автор называет «смелым параллелизмом»: если каждому запущенному агенту можно доверять глубокую проверяемую работу, запускаешь хоть десять агентов одновременно и не боишься за результат.
Установка
По сути pstack — это папка с обычными Agent Skills, где каждый навык лежит в файле skills/<name>/SKILL.md. Ставится через skills CLI одной командой:
npx skills add backnotprop/pstack
Утилита покажет список навыков с поиском, вы отметите нужные и выберете агенты — Claude Code, Codex, Pi, Cursor, OpenCode и другие. Владельцам Cursor доступна и установка как плагина (/add-plugin pstack), а в Claude Code — через маркетплейс плагинов.
Многие навыки в оригинальном плагине были заточены под Cursor. В этом зеркале их переписали так, чтобы они работали в любой среде. Кроме того, зеркало несёт два сообществных исправления, которых ещё нет в оригинале: навык no-comments больше не сносит комментарии о внешних правилах, которые он не может проверить сам (например, про зависимости или платформу), а навык statechart теперь работает на Windows.
poteto-mode: диспетчер на 23 плейбука
Главный навык набора — /poteto-mode. Он читает вашу задачу, подбирает подходящий плейбук и по ходу работы сам вызывает остальные навыки. С ним обычно и работают: автор пишет, что почти всегда начинает задачу именно с него, а остальные навыки подключаются по мере необходимости.
Плейбуков 23, и каждый описывает готовый сценарий работы:
| Плейбук | Задача |
|---|---|
| investigation | вопрос «только для чтения»: как устроен X и почему Y сделан так |
| bug fix | воспроизвести дефект, найти первопричину, починить с доказательствами из рантайма |
| perf | отследить замедленный участок и улучшить его относительно измеренной базы |
| hillclimb | методичное улучшение одной метрики: гипотеза, замер до/после, коммит за каждый принятый шаг |
| runtime forensics | диагностика живого симптома — утечка, загрузка CPU, лаги |
| trace forensics | разбор артефакта профилирования: cpuprofile, trace, heap snapshot |
| feature | новая функция, построенная от именованной структуры данных |
| refactoring | изменение структуры без изменения поведения |
| prototype | одноразовый набросок, чтобы дёшево проверить дизайн или развилку в решении |
| visual parity | попиксельное совпадение двух реализаций интерфейса |
| babysit | доведение PR или стека до готовности к мержу: конфликты, ревью, CI |
| shipping | независимая проверка зелёного стека и последовательное мержение снизу вверх |
| autonomous run | длинная задача без остановок до полного завершения |
| orchestrate | многодневный проект в одном чате-координаторе: стеки PR и флот субагентов |
| autopilot-full | независимые PR до мержа, у каждого свой ответственный |
| session pickup | подхватить незаконченную работу предыдущего агента |
| pause safely | аккуратно приостановить работу, чтобы продолжить позже |
Остальные плейбуки покрывают создание навыков, слепую оценку изменений поведения (eval), паузу и возобновление, многофазные планы, чистку worktree и оформление PR. Типичный запрос выглядит так:
/poteto-mode this pr has a subtle bug where the scroll drifts every 750ms
even when idle. repro first, then fix and verify.
Новичкам пригодится гид pstack: он проводит от настройки до первой настоящей задачи с проверкой результата.
Навыки, которые стоит знать отдельно
Хотя poteto-mode вызывает почти всё сам, несколько навыков полезно запускать и вручную:
/tdd— при багфиксе с дешёвым локальным тестом: сначала падающий тест, потом исправление./arena— N параллельных попыток решить одно и то же, затем сборка лучшего варианта из всех./interrogate— ревью с попыткой сломать дифф разными моделями; остаются только находки, подтверждённые запуском./unslop— вычистка «ИИ-штампов» из текстов./correct— если вы раз за разом поправляете агента в одних и тех же ошибках, навык ищет их классы в истории и устраняет на самом высоком уровне: архитектурой, типами, линтером или CI, а не повторными замечаниями./automate-me— изучает ваши недавние сессии и собирает из них собственный<ваше-имя>-mode, оставляя pstack как основу.
Есть и вспомогательные: /how и /why объясняют устройство и мотивы подсистемы, /teach сводит их в одно понятное объяснение с диаграммами, /blast-radius показывает, что ещё может сломаться от маленького изменения, /benchmark-checklist проверяет, честно ли измерена заявленная цифра, а statechart рисует поведение системы как Mermaid-диаграмму состояний и проверяет модель в TLA+.
24 принципа в виде навыков
Особая часть набора — 24 коротких навыка, по одному инженерному принципу на файл. poteto-mode индексирует их и читает перед каждой задачей. Они сгруппированы так:
| Группа | Суть принципов |
|---|---|
| core | склоняйся к удалению и минимальному изменению; сначала верные структуры данных; вычти, прежде чем добавить; построй инструмент вместо ручной работы |
| architecture | домен живёт в структуре, а не в разбросанных условиях; проверки — на границах системы; нелегальные состояния не должны быть выразимы в типах; операции идемпотентны |
| verification | «докажи, что работает» — реальным артефактом, а не «компилируется»; чини первопричины; разбирай работу на проверяемые шаги; тестируй поведение, а не реализацию; объясняй цифру, прежде чем верить ей |
| delegation | массовую работу уводи в субагентов, в главном чате держи только выжимки; не блокируйся на человеке без необратимых действий |
| meta | правило в форме линтера или скрипта лучше правила в форме текста |
Принцип prove-it-works задаёт тон всей коллекции: задача завершена, когда вы запустили функцию, прочитали реальное значение и посмотрели дифф — а не когда агент отчитался «всё готово».
Модели, субагенты и настройка
pstack рассчитан на несколько моделей сразу: разные задачи отдаются той модели, которая сильна именно в них. По умолчанию poteto-mode отправляет код (фичи, рефакторинг, багфиксы, производительность) в Grok, а самые сложные изменения, тексты и суждения — в Opus. Команда /setup-pstack определяет доступные вам модели и записывает правило, по какой роли какая модель работает.
Для делегирования предусмотрены два субагента. poteto-agent — обёртка над исполнителями, которых poteto-mode запускает по ходу работы; перед любой задачей он целиком читает poteto-mode со всеми принципами, чтобы не дрейфовать от правил. Comment Sicko — беспристрастный ревьюер комментариев, работающий в режиме «только чтение».
Кому подойдёт
pstack — это прежде всего точка зрения: качественная инженерная практика обязательна и для ИИ-агентов, а не только для людей. Набор пригодится командам, которые уже перешли от разовых запросов к агентной работе на постоянной основе: с плейбуками для ночных прогонов, стеков PR и параллельных субагентов. Если стиль Потето вам не подойдёт дословно, /automate-me соберёт ваш собственный режим поверх того же основания. Лицензия — MIT, форки и пул-реквесты приветствуются; смежный проект автора — навык backnotprop/bro, который пересказывает ответы агента простым человеческим языком.
Источник: https://github.com/backnotprop/pstack