Маленькое ядро, острые грани

Pi остаётся минималистичным. Внешним миром занимаются навыки Felo.

Pi поставляет намеренно маленькое ядро агента и предлагает расширять его расширениями, навыками, шаблонами промптов, темами и пакетами. Навыки Felo расширяют его, не добавляя код в ядро: живой поиск, извлечение страниц, транскрипты и вывод презентаций приходят как обычные наборы Markdown.

Создано для Pi~/.pi/agent/skillsПоиск, презентации, транскрипты, X
Установить навыкСмотреть компромиссы

Минималистичный харнесс для программирования в терминале

01Установка Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Корни навыков
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Установка пакета
pi install npm:@scope/pkg или pi install git:github.com/user/repo
04Стандарт
Agent Skills — тот же формат SKILL.md, что и в других харнессах
Попробуйте в каталоге проектаpi # затем попроси скилл, который сохраняет страницу как Markdown
Минимальное ядронавыки — это точка расширения, а не новые инструменты
Четыре корня навыков~/.pi/agent/skills, .pi/skills, .agents/skills, пакеты
npm или curlпоставьте харнесс, затем добавляйте папки
Без песочницычитайте каждый набор до установки
Разделение труда

Что остаётся за Pi, а что должен нести навык

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

Ядро PiНавык Felo
Что этоСреда выполнения, работа с сессиями, TUI, подключение провайдеров и моделейНабор SKILL.md, описывающий одну работу от начала до конца
Как меняетсяРасширения на TypeScript, пакеты, настройки, темыДобавить или убрать папку — без пересборки и перезапуска ядра
Лучше всего дляТого, чтобы харнесс вёл себя так, как работаете выТого, чтобы одна повторяемая задача давала надёжный результат
Доступ к вебуОставлен провайдеру и инструментам, которые вы добавитеЖивой поиск, получение страниц и транскрипты со списками источников
РезультатОриентировано на терминал: поток текста и diffMarkdown, исследовательские заметки и презентации, которые можно передать дальше
Цена проверкиВы проверяете расширения, исполняющие произвольный кодВы читаете процедуру на Markdown, прежде чем ей доверять
Выбранные навыки

Пять навыков Felo, которые не мешают ядру Pi

Pi загружает навыки из ~/.pi/agent/skills, ~/.agents/skills, проектных .pi/skills и .agents/skills или из каталога skills/ внутри пакета. Положите нужное, остальное не берите.

Felo Search

Ответы с источниками
ИсследованиеИсточники

Pi намеренно остаётся минималистичным, поэтому навык — это способ добавить охват, не добавляя инструментов, за которыми нужно следить. Результаты приходят с датами и ссылками, готовые к цитированию в том же ответе.

Пример запросаНайди рекомендуемую версию Node для этой зависимости и укажи, где ты это прочитал.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Открыть страницу Felo Search →

Felo Slides

Презентация из diff
РезультатПрезентация

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

Пример запросаСобери этот рефакторинг в пять слайдов: что переехало, что сломалось, что нужно проверить.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Открыть страницу Felo Slides →

Felo YouTube Subtitling

Транскрипты без браузера
ВидеоТранскрипт

В Pi нет панели браузера, поэтому видеоматериал обычно недостижим. Этот навык забирает субтитры и отдаёт текст, по которому сессия может искать.

Пример запросаЗабери транскрипт этого доклада и вытащи все числа из бенчмарков, которые там упоминаются.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Открыть страницу Felo YouTube Subtitling →

Felo X Search

Что люди сообщают в X
СигналыСоцсети

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

Пример запросаПоищи в X ошибки из этой версии библиотеки и перечисли три самые повторяющиеся.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Открыть страницу Felo X Search →

Felo SuperAgent

Изображения бренда и продукта
ИзображенияБренд

Когда проекту нужен favicon, знак-локап или снимок продукта, та же сессия может их сгенерировать и доработать вместо того, чтобы выдать вам промпт для запуска в другом месте.

Пример запросаНабросай логотип для этого пакета в трёх направлениях и сохрани варианты файлами.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Открыть страницу Felo SuperAgent →
Полный каталог

Выберите навык Felo для установки в Pi

Pi загружает навыки из папки, которой владеете вы, поэтому добавление навыка — это копирование. Выберите работу, которую хотите закрыть следующей: исследование, извлечение данных, презентации, транскрипты, мониторинг соцсетей или длительный рабочий процесс.

Добавить в Pi

Felo Search

Веб-исследование в реальном времени со ссылками на источники

cp -r felo-skills/felo-search ~/.pi/agent/skills/

Felo Web Fetch

Превращение страниц в структурированные данные

cp -r felo-skills/felo-web-fetch ~/.pi/agent/skills/

Felo LiveDoc

Ответы на основе ваших документов

cp -r felo-skills/felo-livedoc ~/.pi/agent/skills/

Felo YouTube Subtitling

Транскрипты докладов, демо и обзоров

cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/

Felo X Search

Отслеживание постов и ответов в X

cp -r felo-skills/felo-x-search ~/.pi/agent/skills/

Felo Slides

Презентация из одного запроса

cp -r felo-skills/felo-slides ~/.pi/agent/skills/

Felo Content to Slides

Заметки и ссылки в структуру презентации

cp -r felo-skills/felo-content-to-slides ~/.pi/agent/skills/

Felo SuperAgent

Долгие процессы, которые помнят контекст

cp -r felo-skills/felo-superagent ~/.pi/agent/skills/

Website Screenshot Agent

Снимки страниц и Markdown

cp -r felo-skills/doc-screenshot-agent ~/.pi/agent/skills/

Felo Twitter Writer

Черновики постов в X из ваших материалов

cp -r felo-skills/felo-twitter-writer ~/.pi/agent/skills/

Felo Landing Page

Лендинг из брифа

cp -r felo-skills/felo-landingpage ~/.pi/agent/skills/

Apple Buy Advisor

Изучение продуктов Apple перед покупкой

cp -r felo-skills/apple-buy-advisor ~/.pi/agent/skills/

Нужен уровень проекта? Скопируйте в .pi/skills/ и подтвердите доверие проекту, когда Pi об этом попросит.

Путь внедрения

Как пользователи Pi добавляют навыки Felo

Обычно сначала ставят одну папку навыка, оставляют сессию открытой и добавляют навыки вывода только после того, как заработает исследование.

Установите одну папку навыка

Pi читает навыки с пользовательского уровня, из проекта или из пакета, поэтому начните с самых узких рамок.

  • ~/.pi/agent/skills — для всех проектов на машине
  • .pi/skills — только для одного репозитория
  • Каталог skills/ внутри пакета, когда команда делит одну настройку

Выполните первый исследовательский запрос

Ценность видна с первого раза, когда сессия отвечает со ссылкой на источник, а не догадкой.

  • Сравните закреплённую зависимость с сегодняшними релизными заметками
  • Проверьте уведомление безопасности перед слиянием
  • Оставьте ответ в терминале, а не во вкладке браузера

Добавьте навыки вывода

Когда исследование работает, та же сессия может создать то, что команда действительно читает.

  • Слайды из diff или из расследования
  • Транскрипты из доклада или демо
  • Отчёты по X перед релизом, изображения, когда проекту нужен знак
Установка

Скопируйте папку или добавьте её пакетом

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

  1. 01

    Установите Pi и войдите

    Воспользуйтесь установкой через npm или shell-установщиком, затем запустите pi в каталоге проекта и авторизуйтесь через /login или ключ API провайдера.

    Терминал
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    # or
    curl -fsSL https://pi.dev/install.sh | sh
    
    # then, in a project directory
    pi
  2. 02

    Подготовьте учётные данные Felo

    Навыки вызывают Felo CLI, поэтому установите его один раз и храните ключ вне репозитория.

    Терминал
    npm install -g felo-ai
    felo config set FELO_API_KEY your-api-key-here
  3. 03

    Добавьте навыки

    Глобальные навыки живут в ~/.pi/agent/skills. Проектные навыки относятся в .pi/skills и загружаются только после того, как вы подтвердите доверие проекту. Если вы держите одну общую папку для нескольких харнессов, подойдёт и ~/.agents/skills.

    Терминал
    git clone https://github.com/Felo-Inc/felo-skills.git
    
    # Every project on this machine
    mkdir -p ~/.pi/agent/skills
    cp -r felo-skills/felo-search ~/.pi/agent/skills/
    
    # Or just this repository
    mkdir -p .pi/skills
    cp -r felo-skills/felo-search .pi/skills/

    Можно также загрузить набор без копирования: pi --skill /path/to/felo-search. Этот флаг добавляется даже при запуске с --no-skills.

  4. 04

    Проверьте, что загрузил Pi

    Pi проверяет навыки на соответствие стандарту Agent Skills и сообщает о большинстве нарушений. Попросите список навыков, затем запустите задачу, которая вам действительно важна.

    Спросить у Pi
    Какие скиллы доступны в этой сессии? Затем через felo-search
    подтяни release notes для нашего драйвера базы данных.
На практике

Что меняется за день сессий в Pi

Три повседневных момента, где навык выигрывает у очередного расширения.

01

Почините ошибку по текущему поведению библиотеки

Стек вызовов указывает в зависимость, а установленная у вас версия отстаёт от документации на два релиза.

ПромптЗабери актуальную документацию по этому методу, сравни сигнатуру с закреплённой версией и исправь место вызова.
Что возвращается

Патч и та самая документация, на которой он основан, вместо догадки, которая компилируется, но ведёт себя странно.

Felo SearchFelo YouTube Subtitling
02

Подготовьте техническую записку, пока пишете код

Нужно объяснить решение «делать самим или купить» команде, которая не читает репозиторий.

ПромптИсследуй текущие цены и лимиты этих трёх сервисов и подготовь шесть слайдов, которые я смогу отредактировать.
Что возвращается

Сравнение с источниками и черновик слайдов, сделанные в одной и той же сессии терминала.

Felo SuperAgentFelo Slides
03

Наверстайте запись релизного события

В докладе вендора о запуске упоминается изменение поведения, которое так и не попало в changelog.

ПромптЗабери транскрипт, перечисли все упомянутые изменения поведения и проверь, какие из них затрагивают нашу конфигурацию.
Что возвращается

Чек-лист, основанный на записи, с таймкодами, которые можно проверить.

Felo YouTube Subtitling
Вопросы

Вопросы, которые возникают в сессии Pi

В чём разница между расширением Pi и навыком Felo?
Расширения — это код на TypeScript, который меняет то, как работает харнесс. Навыки — это процедуры на Markdown, которые агент загружает по необходимости. Наборы Felo — это навыки, поэтому они не исполняются внутри ядра Pi так, как расширение.
Где Pi ищет навыки?
Глобально — в ~/.pi/agent/skills и ~/.agents/skills; для проекта — в .pi/skills и .agents/skills после подтверждения доверия проекту; а также внутри пакетов через каталог skills/ или запись pi.skills в package.json.
Можно ли распространять навыки Felo команде через npm?
Пакеты Pi поддерживают npm, git и локальные пути. Если ваша команда уже ставит общие пакеты через pi install, наборы Felo могут ехать в том же пакете в каталоге skills/.
Нужен ли навыкам Felo ключ API в репозитории?
Нет. Felo CLI читает ~/.felo/config.json. Держите ключ в пользовательском конфиге, чтобы он никогда не попал в коммит проекта.
В Pi нет песочницы разрешений. Это проблема для навыков?
Это причина читать перед установкой. В собственных заметках Pi о безопасности сказано, что навыки могут поручить модели запускать всё, что может запустить пользователь. Держитесь наборов, которые вы проверили, и предпочитайте те, что можно прочитать за минуту.
С какого навыка Felo начать?
Начните с felo-search, если ваша работа зависит от актуальных версий, цен или уведомлений безопасности.

Держите ядро маленьким. Добавляйте нужную возможность.

Скопируйте одну папку в ~/.pi/agent/skills, перезапустите сессию и спросите у Pi то, для чего нужен живой веб.

Felo AI — независимый издатель навыков. Pi поддерживается Earendil Inc.

Когда готовых скиллов мало

Один ключ API. Полный набор инструментов для агента.

Начните со скилла, а затем соберите модели, живые данные, знания и инструменты вывода, которые нужны вашему сценарию в Pi Coding Agent, — с тем же ключом, который уже используют скиллы Felo.

Модели

Используйте экономичный доступ к LLM, когда агенту нужно собственное рассуждение или генерация.

  • LLM API
  • Chat completions
  • Доступ к моделям
Открыть LLM API →

Знания и результат

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

  • LiveDoc
  • Генерация PPT
  • Интеллект-карты
Открыть инструменты знаний →

Творческие инструменты

Расширьте сценарий от исследования до визуальных материалов и результатов, готовых для Office.

  • Генерация изображений
  • Инструменты страниц
  • Вывод для Office
Открыть инструменты платформы →