- JavaScript 84%
- Makefile 16%
- Обновление ссылок и путей к .agentkit и .agentkit.work - Актуализация инструкций подключения и документации - Уточнение открытых замечаний аудита безопасности |
||
|---|---|---|
| prompts | ||
| .gitignore | ||
| LICENSE | ||
| Makefile | ||
| mcp.mjs | ||
| README.md | ||
marketplace.pi
Личный адаптер .agentkit для Pi. Навыки подключаются напрямую из общего источника, а сценарии агентов выполняются в текущей сессии через навыки или prompt templates.
📑 Содержание
- Возможности
- Установка
- Структура
- Особенности Pi
- MCP
- Команды
- Лицензия
🚀 Возможности
- Подключение всех личных навыков из .agentkit.
- Команды
/cli,/project-standardize,/content-analyzeкак prompt templates. - Штатный вызов любого навыка через
/skill:имя. - Собственный формат MCP с параметрами из общего каталога.
⚡ Установка
Требуются Bash, GNU Make, coreutils и awk. По умолчанию kit и адаптер находятся рядом. Для другого расположения KIT_DIR передаётся каждой команде.
make bind
make check
make install
make audit
Цель по умолчанию: ~/.pi/agent; другая цель задаётся через TARGET_DIR. Установка не меняет settings.json, пакеты, модель, расширения, разрешения, MCP и авторизацию. Общие AGENTS.md и особенности рабочей машины подключаются через dotfiles.
📁 Структура
marketplace.pi/
├── prompts/ Три тонких шаблона команд
├── mcp.mjs Преобразователь MCP
└── Makefile
🧭 Особенности Pi
Pi читает SKILL.md по пути из списка доступных навыков; вызов инструмента skill из OpenCode здесь не предполагается. Аргументы /skill:имя добавляются к запросу, а $ARGUMENTS подставляется только в prompt templates адаптера.
Встроенные подагенты не требуются и не имитируются. Доступные инструменты определяются установленной версией Pi и расширениями; отсутствие возможности не компенсируется выдуманным вызовом. Для применения изменённых навыков и templates в активной сессии используется /reload.
Публичный адаптер не содержит личного python-init: канонические Python-навыки находятся в закрытом рабочем kit под именами iris-python-init и iris-python-style.
Установщик проверяет конфликты и ведёт манифест ссылок. Его ограничения проверки владения и родительских симлинков описаны в README .agentkit; полной гарантии сохранности чужих ссылок нет. Для новых или удалённых ресурсов kit повторяется make install.
🔌 MCP
make mcp
Для этой команды требуется Node.js. Вывод — JSON для ручного объединения с ~/.pi/agent/mcp.json; все серверы отключены. Установщик не записывает этот файл и не запускает MCP. Управление встроенным MCP в Pi — /mcp, не /mcps. При Code Mode используется каталог текущего Pi, не синтаксис OpenCode.
После объединения нужным серверам задаётся enabled: true. Для Reddit требуется REDDIT_CLIENT_ID: ссылка ${REDDIT_CLIENT_ID} работает только при наличии переменной в окружении процесса Pi. Если используется локальное значение, оно хранится исключительно в пользовательском mcp.json, не в адаптере или kit; файл должен иметь права 0600.
Проверка подключения выполняется командой pi mcp list. Она запускает включённые серверы и получает каталоги инструментов, но не проверяет выполнение запросов к сайтам. После изменения файла открытой сессии Pi требуется /reload.
🔧 Команды
make help Справка
make bind Привязка kit
make check Структурная проверка
make install Подключение навыков и prompts
make audit Проверка подключённых файлов
make uninstall Удаление собственных ссылок
make mcp Вывод MCP-конфигурации
После удаления личного Python-сценария выполнены bind, check, install, audit: 42 файла подключены успешно, включая пользовательский prompt cli. В локальном Pi 1.4.0 отдельно созданы и включены три MCP-подключения с Code Mode. pi mcp list подтвердил 4PDA — 9 инструментов, Habr — 12, Reddit — 15. Значение идентификатора Reddit в репозиторий не переносилось. Браузерный прогрев 4PDA и запросы к сайтам не запускались. Изолированный сценарий проверки установщика приведён в README .agentkit.
Самостоятельных эксплуатируемых дефектов в собственном коде адаптера статический аудит не подтвердил. При этом Make include и импорт MCP-каталога исполняют внешний код: kit должен быть доверенным даже для help/check/mcp. Это граница доверия, а не гарантия безопасности внешних навыков или установщика.
👤 Автор
Станислав Байков, st.rnd@mail.ru.
📄 Лицензия
MIT.