Brikko PII Mask — 用于保护个人数据的 Skill

该 skill 为你的 agent 提供安全处理客户个人数据的能力：在将文本发送至 LLM 前自动屏蔽其中的个人数据（PII），并在 LLM 返回响应后还原原始数据。

适用场景

请在以下情况使用本 skill：

1. 用户向你提供了包含个人数据（如姓名、ИНН、СНИЛС、ОГРН、ОГРНИП、俄罗斯护照号、电话、邮箱、俄罗斯银行账户）的文本
2. 你需要将该文本发送给 LLM（Claude/GPT/Gemini）以获取响应
3. 用户在俄罗斯境内运营，受《联邦个人数据法》（152-ФЗ）约束，不得将真实个人数据传输至 OpenAI/Anthropic 等外部服务商

请勿使用本 skill 的情形：

• 文本明显为公开内容（如新闻、文档、开放数据集）
• 文本中不包含任何个人数据（skill 将自动识别并返回 count=0）
• 用户明确指示“请原样发送，个人数据无需脱敏”

使用方法

工作流（Workflow）

1. mask:    明文 → 脱敏文本 + mapping_id（保存 1 小时）
2. LLM:     脱敏文本 → 响应（响应中仍含占位符）
3. restore: 响应 + mapping_id → 还原后的响应
4. 将还原后的响应返回给用户

步骤 1 — 对输入文本进行脱敏

python3 scripts/mask.py
# stdin: 含个人数据的文本
# stdout: JSON 格式 {"masked_text", "mapping_id", "count", "audit"}

示例：

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"] → "Клиент , ИНН , тел "
# result["mapping_id"]  → "abc123..."
# result["count"]       → 3

步骤 2 — 将脱敏后的文本发送至 LLM

支持任意模型提供商：Claude API、OpenAI API 或本地部署模型，均无限制。此时文本已不含任何个人数据。请务必保存步骤 1 中返回的 mapping_id，供步骤 3 使用。

步骤 3 — 在 LLM 响应中还原占位符

python3 scripts/restore.py --mapping-id abc123...
# stdin: 来自 LLM 的响应（含占位符）
# stdout: 含真实个人数据的文本

restored = subprocess.check_output(
    ["python3", "scripts/restore.py", "--mapping-id", result["mapping_id"]],
    input=llm_response, text=True
).strip()
# restored 中包含真实姓名/ИНН/电话，而非 //

配置说明

本 skill 使用 Brikko Gateway API（https://api.brikko.ru/v1/anonymize 和 /v1/restore）。获取 API 密钥的方法如下：

1. 在 brikko.ru 注册账号（免费注册，新用户赠送 200 ₽ 欢迎额度，Studio 用户可直接使用）
2. 创建 API 密钥：登录 brikko.ru → 进入 /app 页面 → 点击「创建 API 密钥」
3. 将密钥导出至环境变量：export BRIKKO_API_KEY=sk-brk-...

计费说明：在 M2 环境中，数据脱敏服务免费（本 skill 推广期专属优惠）。仅通过 api.brikko.ru 发起的 chat-completions 请求按各模型提供商标准费率计费，并额外加收 15% Brikko 平台服务费。

自托管替代方案：可通过 npm install -g brikko-cli && brikko init 在本地安装 Brikko Studio；当环境变量 BRIKKO_API_URL 指向 http://localhost:3737 时，skill 将自动切换至本地服务。

支持检测的数据类型

得益于 checksum 校验机制，误报率（False-positive ratio）低于 1%（若无该校验，文本中任意连续 10 位数字——例如缺少 +7 前缀的电话号码或设备序列号——均可能被误判为 INN）。

隐私与审计（Privacy & Audit）

• 原始个人数据 永远不会离开你的本地机器，仅在 HTTPS（TLS 1.3，证书由 Let's Encrypt 签发）加密通道下传输至 api.brikko.ru
• 映射关系（占位符 ↔ 原始值）存储于 api.brikko.ru 的 Redis 实例中，TTL 设为 1 小时，超时后自动清除
• Brikko 审计日志（Audit-log）仅记录数据类别及数量统计，不记录明文数据，例如仅记录「3 NAME, 1 INN, 2 PHONE」，而不会记录具体姓名或号码
• 若采用自托管模式（Docker Compose 本地部署 Brikko Studio），所有数据完全保留在本地机器内，不外传

异常处理（Failure modes）

验证方法（Verify）

# 将本 skill 集成至 OpenClaw / Claude Code 项目
# （具体集成方式依所选生态而定，请参考 README.md）

# 测试请求
echo "Клиент Иванов, ИНН 7707083893" | python3 scripts/mask.py
# 期望 stdout：JSON 格式，含 masked_text="Клиент , ИНН "

支持渠道

• 官方文档：https://brikko.ru/docs/skills/pii-mask
• 问题反馈（Issues）：https://github.com/brikkoAI/brikko-pii-skill/issues
• 邮箱：hello@brikko.ru
• Telegram：@brikko_ru