Початок роботи
Навички для AI-агентів
Додайте знання та робочі процеси BroSettlement до будь-якого AI-агента, який підтримує відкритий формат Agent Skills із файлом `SKILL.md`.
Встановлення через AI-агента
Скопіюйте цей запит і вставте його в AI-чат, який може завантажувати файли та встановлювати Agent Skills:
Встанови комплект 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.
Приклади запитів
Use $brosettlement-onboarding to configure a new testnet organization.Продовж налаштування BroSettlement. Co-Signer встановлений, але Console показує Offline.Допоможи ініціалізувати 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, тому агент може перевірити, адаптувати, протестувати та зібрати їх у вашому проєкті.
Приклади запитів
Use $brosettlement-api to list all wallet-related API commands.Знайди у Swagger операцію створення транзакції та покажи її request body.Створи підписаний Go-запит для цього endpoint і поясни, які environment variables потрібно передати.Запусти WebSocket listener із повторним підключенням і збереженням подій у JSONL.Обмеження безпеки
Skill використовує Swagger як джерело істини, чітко позначає staging-приклади й не вигадує production endpoint. Credentials зчитуються під час виконання з дозволених environment variables або сховища secrets. Skill не записує в журнали приватні ключі чи повні secrets і просить підтвердження перед запитами, які можуть створити, перемістити або змінити реальні активи.
Що входить до пакета
Єдиний ZIP містить дві переносні сусідні папки skills:
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
- Завантажте та перевірте BroSettlement Agent Skills ZIP.
- Розпакуйте
brosettlement-onboardingіbrosettlement-api. - Скопіюйте обидві папки до одного проєктного або особистого каталогу skills, який підтримує ваш агент.
- Перезапустіть або перезавантажте агента.
- Один раз викличте skill явно:
Use $brosettlement-onboarding to help me configure a new testnet organization.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.