Навыки Felo для Pi Coding Agent: Малое ядро, живой веб
Добавьте навыки Felo в Pi Coding Agent для живого поиска, транскрипций, X-сигналов и черновиков слайдов — без добавления ни одной строки кода в минимальное ядро.
Ядро Pi Coding Agent остается малым по замыслу. В нем нет подагентов и режима планирования, и интерфейс, который вы видите в первый день, не меняется через полгода.
Такое ограничение — осознанный выбор. Меньше внутренних компонентов — меньше сбоев, меньше необходимости синхронизировать части, и сессия ведет себя одинаково через квартал.
У ограничения есть предел. Как только задача требует живого веба — сегодняшних релиз-нот, страницы, которую нельзя вставить, записи конференции, обсуждений новой версии — минимальное ядро не может помочь.
Навыки — это точка расширения, которую предлагает Pi. Навыки для Pi Coding Agent — это обычные папки с Markdown, а не скомпилированные плагины. Пакеты Felo расширяют возможности сессии, не попадая в ядро.
Навыки — это точка расширения, а не новые инструменты
Документация Pi прямо указывает на рамки: ядро остается малым, функции вроде подагентов и режима планирования отсутствуют. Знания по задачам размещаются в навыках, которые агент загружает по мере необходимости.
| Ядро Pi | Навык Felo | |
|---|---|---|
| Что это | Исполнение, управление сессией, TUI, интеграция провайдера и модели | Пакет SKILL.md, описывающий одну задачу от начала до конца |
| Как меняется | Расширения на TypeScript, пакеты, настройки, темы | Добавьте или удалите папку — пересборка не нужна |
| Доступ к вебу | Зависит от провайдера и добавленных инструментов | Живой поиск, загрузка страниц и транскрипции с источниками |
| Нагрузка на ревью | Аудит расширений, которые запускают произвольный код | Просмотр Markdown-процедуры перед доверием |
Расширение — это код с теми же возможностями, что и сам агент. Навык — процедура, которую можно прочитать за пару минут и отклонить.
Где Pi ищет навыки. Четыре корневых папки плюс пакеты:
~/.pi/agent/skills— для всех проектов на машине~/.agents/skills— общее место, доступное для всех совместимых оболочек.pi/skills— для одного репозитория, загружается только после доверия проекту.agents/skills— то же, но в общем месте- директория
skills/в пакете или записьpi.skillsвpackage.json
Pi проверяет навыки по стандарту Agent Skills и сообщает о большинстве нарушений, поэтому папка SKILL.md, уже работающая в другой оболочке, заработает и здесь после cp -r. Навыки Pi — это ваши папки, а не плагины, встроенные в бинарник.
Корневые папки на уровне проекта загружаются только после подтверждения доверия. Этот барьер защищает: свежий клон репозитория не должен внедрять новую процедуру только потому, что вы запустили pi внутри него.
Расширение или навык? Пакеты Felo — это навыки, не расширения; они не исполняются внутри ядра Pi.
Как добавить навык. В каталоге проекта скопируйте пакет в корневую папку навыков или используйте пакет:
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Если один и тот же пакет нужен на нескольких машинах, используйте пакет:
pi install npm:@scope/pkg
pi install git:github.com/user/repo
Можно загрузить навык без копирования: pi --skill /path/to/felo-search. Флаг добавляет навык, даже если сессия стартует с --no-skills.
Ключи не попадают в репозиторий. Установите Felo CLI один раз, сохраните ключ в пользовательской конфигурации, и каждый навык его подхватит:
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
CLI читает ~/.felo/config.json, поэтому ключ не попадает в коммит. Обычно пользователи Pi начинают с одной папки, убеждаются, что поиск работает, и только потом добавляют навыки, которые формируют результат.
Пять навыков Felo, которые стоит добавить
Каждый решает задачу, недоступную терминалу.
Felo Search — ответы с источниками
Исследование, на котором строятся остальные навыки. Доступ к живому вебу, результаты с датами и ссылками, готовые к цитированию в вашем ответе.
Найди рекомендуемую версию Node для этой зависимости и укажи источник.
Felo Slides — презентация из сессии
Рецензенты читают презентации, а не вывод терминала. Сначала приходит текстовый план внутри Pi, чтобы вы могли поправить аргументацию до создания слайдов. Потом формируется файл, а источники попадают в заметки для докладчика.
Кратко опиши этот рефакторинг в пяти слайдах: что изменилось, что сломалось, что требует проверки.
Felo YouTube Subtitling — транскрипции без браузера
В Pi нет браузера, поэтому видео обычно недоступно. Этот навык получает субтитры и возвращает текст, который можно искать, цитировать и сверять с вашей конфигурацией.
Получи транскрипцию этого доклада и выпиши все упомянутые в нем бенчмарки.
Felo X Search — что пишут о версии на X
Полезно перед релизом: узнайте, сталкивается ли кто-то еще с такой же ошибкой на этой версии.
Найди на X ошибки для этой версии библиотеки и перечисли три самых частых.
Felo SuperAgent — изображения в той же сессии
Если проекту нужен фавикон, логотип или снимок продукта, сессия может сгенерировать и доработать их, не передавая запрос в другое место.
Нарисуй логотип для этого пакета в трех вариантах и сохрани файлы.
Полный каталог: felo.ai/skills/pi-coding-agent — включая Felo Web Fetch для преобразования страниц в структурированные данные и Felo LiveDoc, который отвечает на основе ваших документов, а не открытого веба.
Три сценария, которые стоит попробовать
Написаны так, как вы бы их ввели.
Исправить баг с учетом текущего поведения библиотеки
Стек-трейс указывает на зависимость, а ваша версия отличается от документации на два релиза — в любую сторону.
Получи актуальную документацию по этому методу, сравни сигнатуру с закрепленной версией и исправь вызов.
В ответе — патч и точная документация, на которую он опирается. Не догадка, которая компилируется, но ведет себя странно под нагрузкой.
Подготовить техническую записку во время работы
Нужно объяснить решение build-versus-buy людям, которые не откроют репозиторий.
Найди актуальные цены и лимиты для этих трех сервисов и набросай шесть слайдов для редактирования.
Сравнение с источниками и черновик слайдов — из той же сессии, где еще открыт ваш код. Черновик легко менять, а готовую презентацию приходится пересобирать и согласовывать. Слайды доступны и напрямую на felo.ai/slides, если вы хотите доработать их вне терминала.
Разобраться с записью релизного события
Вендор в докладе упоминает изменения, которых нет в changelog.
Получи транскрипцию, выпиши все изменения поведения и проверь, какие из них влияют на наш конфиг.
Чек-лист с привязкой ко времени в записи — не пересказ, которому нужно верить на слово.
Ограничения
В Pi нет песочницы разрешений. Это важно, и это должно быть в статье, а не в сноске. В заметках по безопасности Pi прямо сказано: навык может поручить модели выполнить все, что может пользователь. Навык обладает той же силой, что и ваша учетная запись в системе. Поэтому навыки нужно читать перед установкой, а не избегать их.
Сначала прочитайте пакет. Навыки Felo — это обычный Markdown. Откройте SKILL.md, просмотрите, какие команды он предлагает модели. Это разумная практика для любых AI-навыков; в Pi это вся модель безопасности. Если пакет слишком длинный для быстрого просмотра, это уже находка. Установка — это копирование папки, удаление — просто удаление папки, без скриптов и следов в ядре.
Соблюдайте барьер доверия. Навыки из .pi/skills и .agents/skills на уровне проекта загружаются только после доверия проекту. Пользовательские корни — для пакетов, которые вы выбрали осознанно. Пусть область проекта останется достаточно малой, чтобы вы заметили новую папку.
Храните ключ в пользовательской конфигурации. Felo CLI читает ~/.felo/config.json. Если ключ API появляется в .pi/skills проекта — это ошибка настройки, а не поведения навыка, и такая ошибка легко попадает в коммит.
Требуйте источники в ответах. Главное преимущество навыка — каждая ссылка снабжена датой и местом для проверки. Уточняйте этот формат, если он не стоит по умолчанию.
FAQ
В чем разница между расширением 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/.
Нужно ли хранить ключ API Felo в репозитории?
Нет. Felo CLI читает ~/.felo/config.json. Храните ключ в пользовательской конфигурации, чтобы он не попал в коммит.
В Pi нет песочницы разрешений. Это проблема для навыков?
Это причина читать навык перед установкой. В документации Pi прямо указано: навык обладает всеми возможностями вашей учетной записи. Используйте только те пакеты, которые вы просмотрели, и отдавайте предпочтение тем, что можно прочитать за минуту.
С какого навыка Felo начать?
Начните с Felo Search, если ваша работа зависит от актуальных версий, цен или предупреждений. Остальные навыки становятся полезнее, когда ответы приходят с источником.
Выберите навык, который решает вашу частую тупиковую задачу, скопируйте папку в ~/.pi/agent/skills и задайте следующий вопрос, ожидая источник вместо догадки. Ядро останется таким же малым — сессия просто перестанет гадать.
Посмотреть навыки Felo для Pi Coding Agent →
Эта статья также доступна на следующих языках: English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা and Português.