Brikko PII Mask — Skill для защиты персональных данных#

Этот skill добавляет твоему агенту возможность безопасно работать с персональными данными клиентов: маскирует ПД в тексте перед отправкой в LLM и восстанавливает в ответе.

Когда использовать#

Используй этот skill когда:

1. Пользователь дал тебе текст с персональными данными (ФИО, ИНН, СНИЛС, ОГРН, ОГРНИП, паспорт РФ, телефон, email, банковский счёт)
2. Тебе нужно отправить этот текст в LLM (Claude/GPT/Gemini), чтобы получить ответ
3. Пользователь работает в РФ под 152-ФЗ и не имеет права передавать реальные ПД в OpenAI/Anthropic

Не используй когда:

• Текст явно публичный (новости, документация, открытые данные)
• ПД нет в тексте (skill сам определит и вернёт count=0)
• Пользователь явно сказал «отправь как есть, ПД не критичны»

Как использовать#

Workflow#

text

1. mask:    plaintext → masked text + mapping_id (хранится 1 час)
2. LLM:     masked text → answer (там тоже плейсхолдеры)
3. restore: answer + mapping_id → восстановленный ответ
4. отдать пользователю восстановленный ответ

Шаг 1 — маскировать вход#

bash

python3 scripts/mask.py
# stdin: текст с ПД
# stdout: JSON {"masked_text", "mapping_id", "count", "audit"}

Пример:

python

import json, subprocess
text = "Клиент Иванов Иван Иванович, ИНН 7707083893, тел +7 999 123 45 67"
result = json.loads(subprocess.check_output(
    ["python3", "scripts/mask.py"],
    input=text, text=True
))
# result["masked_text"] → "Клиент <NAME_1>, ИНН <INN_1>, тел <PHONE_1>"
# result["mapping_id"]  → "abc123..."
# result["count"]       → 3

Шаг 2 — отправить замаскированный текст в LLM#

Любой провайдер: Claude API, OpenAI API, локальная модель — без разницы. Текст уже без ПД. Сохрани mapping_id для шага 3.

Шаг 3 — восстановить плейсхолдеры в ответе#

bash

python3 scripts/restore.py --mapping-id abc123...
# stdin: ответ от LLM (с плейсхолдерами)
# stdout: текст с реальными ПД

python

restored = subprocess.check_output(
    ["python3", "scripts/restore.py", "--mapping-id", result["mapping_id"]],
    input=llm_response, text=True
).strip()
# restored содержит реальные имена/ИНН/телефоны вместо <NAME_1>/<INN_1>/<PHONE_1>

Конфигурация#

Skill использует Brikko Gateway API ( https://api.brikko.ru/v1/anonymize, /v1/restore). Чтобы получить API-ключ:

1. Регистрация на brikko.ru (бесплатно, 200 ₽ welcome credit, для Studio-юзеров)
2. Создать ключ: brikko.ru → /app → «Создать API-ключ»
3. Экспортировать в окружение: export BRIKKO_API_KEY=sk-brk-...

Тарифы: анонимизация бесплатна в M2 (promo для adoption этого skill). Только chat-completions через api.brikko.ru тарифицируются по обычным ставкам провайдеров + 15% наценка Brikko.

Self-hosted alternative: установи Brikko Studio локально через npm install -g brikko-cli && brikko init — skill автоматически переключится на http://localhost:3737 если BRIKKO_API_URL указывает туда.

Что детектируется#

КатегорияПримерыChecksum-валидацияNAMEИванов / Иванову / Иванова (склонения)—INN7707083893 (10 цифр для юрлиц), 770708389300 (12 для физлиц)✓ алгоритм ФНСSNILS123-456-789 01✓OGRN1027700132195 (13 цифр)✓OGRNIP304500116000157 (15 цифр)✓PASSPORT_RF4509 123456regexPHONE_RF+7 999 123 45 67, 8(495)1234567regexEMAILuser@example.comregexBANK_ACCOUNT_RF40702810500000123456 (20 цифр)✓ контрольная цифраIPV4192.168.1.1regex

False-positive ratio < 1% за счёт checksum-валидации (без него случайные 10 цифр в тексте — например телефон без +7 или серийник детали — попадали бы в категорию INN).

Privacy & Audit#

• Plaintext ПД никогда не покидают твою машину дальше api.brikko.ru (HTTPS, TLS 1.3, certs от Let's Encrypt)
• Mapping (плейсхолдер → оригинал) хранится в Redis на api.brikko.ru с TTL 1 час, после удаляется автоматически
• Audit-log Brikko содержит только категории и счётчики, не plaintext — «3 NAME, 1 INN, 2 PHONE» а не сами имена/номера
• При self-hosted Studio (Docker compose locally) — данные вообще не покидают локальную машину

Failure modes#

ОшибкаSkill делаетНет BRIKKO_API_KEY в envexit 2, hint про регистрациюapi.brikko.ru недоступенretry 3 раза, потом exit 1 с сетевым диагнозомmapping_id истёк (>1 ч между mask и restore)возвращает текст с плейсхолдерами как есть + warningТекст > 1 MBexit 2, hint разбить на чанки

Verify#

bash

# Установить skill в проект OpenClaw / Claude Code
# (детали — по выбранной экосистеме, см. README.md)

# Тест-запрос
echo "Клиент Иванов, ИНН 7707083893" | python3 scripts/mask.py
# Ожидаемый stdout: JSON с masked_text="Клиент <NAME_1>, ИНН <INN_1>"

Поддержка#

• Документация: https://brikko.ru/docs/skills/pii-mask
• Issues: https://github.com/brikkoAI/brikko-pii-skill/issues
• Email: hello@brikko.ru
• Telegram: @brikko_ru