Навички для AI-агентів

Початок роботи

Навички для AI-агентів

Додайте знання та робочі процеси BroSettlement до будь-якого AI-агента, який підтримує відкритий формат Agent Skills із файлом `SKILL.md`.

Встановлення через AI-агента

Скопіюйте цей запит і вставте його в AI-чат, який може завантажувати файли та встановлювати Agent Skills:

text
Встанови комплект BroSettlement Agent Skills з https://www.brolabel.io/agent-skills/brosettlement-agent-skills.zip.

Завантаж і перевір архів. Встанови `brosettlement-onboarding` і `brosettlement-api` у каталог skills, який підтримує цей AI-агент, зберігши їх як сусідні папки. Не запускай налаштування BroSettlement і не запитуй credentials під час інсталяції. Якщо потрібно, перезавантаж або повторно знайди skills, а потім перевір, що доступні обидва.

Після інсталяції активуй `$brosettlement-onboarding` і проведи мене через налаштування нової testnet-організації BroSettlement. Якщо автоматична інсталяція не підтримується, назви точний каталог призначення та наступну дію замість того, щоб повідомляти про неіснуючий успіх.

Prompt встановлює один архів з обома необхідними skills. Під час onboarding Onboarding skill використовує API skill для перевірки актуального Swagger-контракту, підписаних API-запитів, ініціалізації MPC та перевірки віддалених статусів.

Два skills, один комплект

SkillДля яких задачРезультат
BroSettlement OnboardingНалаштування нової організації або нового хоста Co-SignerЗапущений Co-Signer, ініціалізований MPC/DKG і перший testnet-гаманець
BroSettlement APIДослідження та інтеграція REST API і WebSocket-подійЗнайдені API-команди, коректно підписані запити та робочий listener подій

BroSettlement Onboarding

Встановлюється prompt вище як частина комплекту BroSettlement Agent Skills.

Цей skill перетворює Quickstart на інтерактивного помічника з налаштування. Він зберігає прогрес, ставить по одному запитанню, пояснює призначення кожного кроку й чекає підтвердження перед переходом далі.

Що він уміє

  • Перевірити, чи вже є акаунт BroSettlement і доступ до організації. Якщо доступу немає, пояснити, що потрібно завершити до початку технічного налаштування.
  • Запитати, у якій папці встановити Co-Signer, і перевірити вибране розташування перед створенням або зміною файлів.
  • Перевірити необхідне програмне забезпечення, доступи хоста, права та вихідну IP-адресу, яку може знадобитися додати до allowlist.
  • Створити необхідну пару ключів Ed25519 без перезапису наявного ключа та без передавання приватного ключа в чат.
  • Надати точні ручні інструкції для створення API key у BroSettlement Console з дозволами Initialize MPC, Read MPC і Raw MPC co-signer; ключ завжди створює користувач, а skill ніколи не керує розділом API Keys.
  • Встановити Co-Signer, підготувати конфігурацію, виконати перевірку або збірку та запустити сервіс.
  • Перевірити обидві сторони з’єднання: локальний health endpoint і статус Online у BroSettlement Console.
  • Використовувати BroSettlement API skill для підписаних REST-запитів, перевірки актуального Swagger та віддалених статусів.
  • Запускати MPC/DKG через API skill лише після успішної перевірки Co-Signer, а потім перевіряти GET /api/v1/mpc/status до завершення або зрозумілої помилки.
  • Завершити перший сценарій через API skill: створити та повторно прочитати рахунок в операційному журналі й testnet-гаманець.
  • Пояснити підготовку до робочого режиму: автоматичний перезапуск процесу, моніторинг журналів, зашифровані резервні копії, перевірку відновлення та ротацію secrets.

Приклади запитів

text
Use $brosettlement-onboarding to configure a new testnet organization.
text
Продовж налаштування BroSettlement. Co-Signer встановлений, але Console показує Offline.
text
Допоможи ініціалізувати MPC і створити перший testnet-гаманець.

Обмеження безпеки

Skill не просить вставляти приватні ключі, API secrets або матеріали для відновлення в чат. Він не перезаписує ключі чи конфігурацію без підтвердження, не запускає MPC до проходження health checks і залишає перший сценарій із гаманцем у testnet, якщо ви явно не попросили та не підтвердили операцію в production.

BroSettlement API

Встановлюється prompt вище як частина комплекту BroSettlement Agent Skills.

Цей skill допомагає агенту працювати з актуальним контрактом інтеграції, а не зі статичним переліком команд. Поточне джерело — staging Swagger UI. Посилання на production-документацію буде додано, коли вона стане доступною.

Що він уміє

  • Завантажити та перевірити актуальний staging OpenAPI-документ перед реалізацією запиту.
  • Показати всі доступні команди або знайти їх за назвою операції, шляхом, HTTP-методом, тегом чи довільним пошуковим запитом.
  • Пояснити схеми request і response, обов’язкові headers, автентифікацію, дозволи, параметри та типові помилки API.
  • Створювати й надсилати REST-запити з Ed25519-підписом, використовуючи для підпису саме ті байти, які будуть відправлені.
  • Коректно обробляти hash body, canonical signing input, timestamp запиту та вимоги idempotency без розкриття приватного ключа.
  • Підключатися до BroSettlement WebSocket, автентифікувати сесію, виводити або зберігати події у форматі JSON Lines і повторно підключатися з backoff після розриву з’єднання.
  • Діагностувати помилки підпису, недійсні або відкликані API keys, відсутні дозволи, помилки валідації схем і проблеми автентифікації WebSocket.
  • Допомогти виконати звірку WebSocket-подій із REST-ресурсами та операційним журналом BroSettlement.

Вбудовані утиліти

УтилітаЩо робить
list-commandsЗавантажує Swagger і показує або шукає доступні API-операції
api-requestФормує, підписує, надсилає та виводить REST-запит BroSettlement
ws-listenerАвтентифікується, слухає WebSocket-події, повторно підключається та за потреби записує JSONL
sign-request.mjsСтворює підписані headers за допомогою Node.js без зовнішніх залежностей

Для Go-утиліт потрібен Go 1.24 або новіший. Вони постачаються як читабельний source code, тому агент може перевірити, адаптувати, протестувати та зібрати їх у вашому проєкті.

Приклади запитів

text
Use $brosettlement-api to list all wallet-related API commands.
text
Знайди у Swagger операцію створення транзакції та покажи її request body.
text
Створи підписаний Go-запит для цього endpoint і поясни, які environment variables потрібно передати.
text
Запусти WebSocket listener із повторним підключенням і збереженням подій у JSONL.

Обмеження безпеки

Skill використовує Swagger як джерело істини, чітко позначає staging-приклади й не вигадує production endpoint. Credentials зчитуються під час виконання з дозволених environment variables або сховища secrets. Skill не записує в журнали приватні ключі чи повні secrets і просить підтвердження перед запитами, які можуть створити, перемістити або змінити реальні активи.

Що входить до пакета

Єдиний ZIP містить дві переносні сусідні папки skills:

text
brosettlement-onboarding/
├── SKILL.md
├── references/
└── agents/
brosettlement-api/
├── SKILL.md
├── references/
├── scripts/
└── agents/

Кожен SKILL.md — універсальна точка входу для агентів. Onboarding skill очікує API skill у сусідній папці та передає йому підписані API-операції й перевірку статусів. У references зберігається детальний контекст, який агент завантажує лише за потреби. API skill також містить описані вище Go- та Node.js-утиліти.

Встановлення в агент із підтримкою skills

  1. Завантажте та перевірте BroSettlement Agent Skills ZIP.
  2. Розпакуйте brosettlement-onboarding і brosettlement-api.
  3. Скопіюйте обидві папки до одного проєктного або особистого каталогу skills, який підтримує ваш агент.
  4. Перезапустіть або перезавантажте агента.
  5. Один раз викличте skill явно:
text
Use $brosettlement-onboarding to help me configure a new testnet organization.
text
Use $brosettlement-api to implement a signed request for the BroSettlement API.

Надалі агент також може активувати skill автоматично, коли запит відповідає його опису.

Агенти без вбудованої підтримки skills

Відкрийте SKILL.md і додайте його до проєктних інструкцій або knowledge вашого агента. Збережіть відносну структуру references/ і scripts/, щоб агент мав доступ до ресурсів пакета.

Відкритий формат

Пакети відповідають специфікації Agent Skills: папка з обов’язковим SKILL.md та необов’язковими scripts, references і assets.