pstack — набор навыков и 24 инженерных принципа для строгой работы с ИИ-агентами

· 6 мин чтения
agent-skills skills claude-code ai-agents tdd
📂 Исходный код на GitHub

Зеркало плагина cursor/plugins/pstack: почти 60 agent skills для строгой инженерии с ИИ-агентами — диспетчер poteto-mode с 23 плейбуками, 24 принципа кодирования, субагенты и мульти-модельные рабочие процессы. Работает в Claude Code, Codex, Pi, Cursor и OpenCode.

pstack — набор навыков и 24 инженерных принципа для строгой работы с ИИ-агентами

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