pi-config — воркфлоу
Личная конфигурация агента Pi с четырьмя командами: план, задачи, исполнение и ревью через файлы сессии в Markdown.
- 459 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- `setup.sh` исполняется на вашей машине, ставит пакеты из Git и на macOS рантайм с управлением рабочим столом.
- Через расширение `execute_command` агент сам вызывает слэш-команды, а исполнители делают коммиты без запроса подтверждения.
- Конфигурация подменяет глобальный каталог агента `~/.pi/agent/`, включая модели и `mcp.json`.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add workflows/pi-configОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `setup.sh` исполняется на вашей машине, ставит пакеты из Git и на macOS рантайм с управлением рабочим столом.
- Через расширение `execute_command` агент сам вызывает слэш-команды, а исполнители делают коммиты без запроса подтверждения.
- Конфигурация подменяет глобальный каталог агента `~/.pi/agent/`, включая модели и `mcp.json`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий клонируют в `~/.pi/agent/` как глобальную настройку агента Pi. В нем лежат настройки, модели, `mcp.json`, шаблоны промптов и скиллы. Рабочий цикл из четырех команд: `/plan` исследует задачу и фиксирует подход, `/todos` режет план на задачи для исполнителей, `/execute` запускает исполнителей по очереди и проверяет каждый коммит, `/review` собирает независимую команду ревью и чинит замечания. Состояние между шагами лежит в обычных файлах Markdown рядом с файлом сессии: `.plan.md`, `.todos.md` и `.review.md`. Оркестрацию ведет CLI `sc` (Superconductor), а скиллы `commit`, `scout`, `worker`, `review` задают правила для отдельных ролей.
Для кого. Опытные пользователи Pi, которым нужен готовый цикл план, задачи, исполнение, ревью и желание подстроить его под себя.
Подходит, если
- Большая задача требует плана и разбиения на проверяемые шаги.
- Исполнители должны работать по очереди и оставлять по одному коммиту.
- Готовую работу проверяет независимая команда, а не тот же агент.
- Нужен образец, как устроены скиллы и промпты Pi.
Не подходит, если
- Агент не Pi: конфигурация рассчитана на его каталог и формат скиллов.
- Нет доступа к `sc`, а оркестрация без него не работает.
- Нужна нейтральная настройка: репозиторий отражает вкусы одного автора.
Пример запроса к агенту
/plan добавить экспорт отчета в CSV. Затем /todos, /execute и /review по готовому плану.Ограничения
Это личная настройка автора, а не универсальный пакет. `setup.sh` требует клона ровно в `~/.pi/agent/`, сохраняет существующий `settings.json`, ставит пакеты из Git и на macOS добавляет рантайм macOS Harness через `uv`. Нужны `PI_SESSION_FILE`, ключи провайдеров в `auth.json` и CLI `sc`. Проверка в README опирается на `jq` и модель `gpt-5.6`. Скиллы и промпты написаны под вкусы автора, поэтому перед использованием их стоит прочитать и подправить под свою команду.
Как отключить. Остановите Pi и верните прежний каталог `~/.pi/agent/` из резервной копии либо удалите клон. Пакеты, поставленные `setup.sh`, и рантайм macOS Harness снимайте отдельно.
Частые вопросы
Что делает `/execute`?
Читает план и задачи, запускает исполнителей по очереди, проверяет каждый коммит через Git и обновляет файл задач из сессии координатора. Исполнители в файл задач не пишут.
Сколько раундов исправлений делает `/review`?
Не больше двух. При вердикте `NEEDS CHANGES` запускаются последовательные исполнители, затем идет повторное ревью до одобрения или остановки.
Нужны ли `/plan` и `/todos` перед `/review`?
Нет. Для ревью достаточно JSONL сессии, файлы плана и задач служат необязательным контекстом.
Куда идет вся работа с Git?
Рабочий процесс не создает ветки, не пушит и не открывает PR. Эти шаги выполняются только по отдельной просьбе.
Какие скиллы входят в репозиторий?
`plan`, `write-todos`, `worker`, `review`, `scout`, `superconductor`, `commit` и другие. Полный список лежит в таблице раскладки каталогов в README.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВоркфлоуМинималистичный агент для кода в терминале, который расширяется скиллами, шаблонами промптов и пакетами на TypeScript
Набор расширений для агента Pi: разбор чужих репозиториев, секреты с TTL, поиск по сессиям агентов.
Фоновый запуск кодовых агентов pi у вас на машине по расписанию и меткам: каждое задание в контейнере Docker и с лимитом трат.
Веб-приложение для кодингового агента Pi: сессии переживают перезапуск, к ним можно подключать коллег и работать с телефона, без облачной виртуалки
Веб-панель для кодинг-агента pi с группировкой сессий по веткам, встроенным терминалом и мобильным режимом
Повторяющиеся шаги агента pi копятся как программы на JavaScript с манифестом и тестами, и pi вызывает их вместо ручного повтора.
Коротко о README
В README разобраны установка в `~/.pi/agent/`, четыре команды цикла, политику Superconductor и раскладку каталогов. Состояние хранится в Markdown без служебных баз и каталогов запуска.