敏感文件脱敏 Skill:本地扫描文档并生成可读的脱敏副本

前言

合同、客户清单、财务表和内部报告在对外共享前,往往需要去掉姓名、证件号、银行卡和机构名称。手工查找替换容易漏项,统一改成 [REDACTED] 又会让表格和段落难以继续阅读。若希望 Agent 按规则扫描、出报告,并用一致性较好的假数据替换敏感值,同时尽量不破坏 DOCX、Markdown 或 Excel 的结构,可以把这个能力做成 Skill 挂在当前客户端上。下面介绍 SkillHub 上的「敏感文件脱敏 Skill」及其安装与使用要点。

这是什么

「敏感文件脱敏 Skill」(坐标 @user_c0e4b78f/anonymize-sensitive-files,当前版本 1.0.2)是社区来源(community)的 ai-agent 类 Skill,由发布者 user_c0e4b78f 维护;SkillHub 页面标注作者为 zongzack。标签 requires_api_key=false,表示按 SkillHub 元数据不依赖额外 API Key。

它面向「文档脱敏」场景:扫描并替换文档中的姓名、手机号、邮箱、身份证号、统一社会信用代码、银行卡号、银行联行号、地址、合同编号、公司/机构名及自定义敏感词等,并尽量保留原文可读结构。适合合同、客户资料、采购文件、财务文件、内部报告、简历及需在共享前去敏的业务文档。当你在对话里提到脱敏、匿名化、敏感信息、个人信息、身份证、手机号、邮箱、银行卡、合同、客户、项目或密钥等需求时,Agent 可据此选用该 Skill。

核心功能

以下能力均来自 SkillHub 官方说明,可按工作流理解为「扫描 → 校验 → 脱敏」:

  1. 扫描与报告:扫描敏感信息并生成 JSON 报告。
  2. 安全输出:生成脱敏副本,不覆盖原文件。
  3. 替换策略:用真实感假数据替换原值,而非简单写成 [REDACTED];同一次运行中,相同原值映射为相同假值,便于对照结构。
  4. 词表:支持自定义敏感词表。
  5. 表格与 Excel 字段规则:
    - Markdown 表格、DOCX 表格、Excel 工作表支持相邻字段,例如 A1=法定代表人、B1=某姓名。
    - Excel 还支持列头在上、值在下的规则,例如 A1=姓名、A2=某姓名。
  6. Excel 与宏相关:
    - 处理范围包括工作簿属性、工作表名、字符串单元格、hyperlink 的文本与目标;尽量保留工作簿、样式、隐藏表和宏。
    - 批注、图片、图表、文本框、透视表、嵌入对象和宏代码需额外人工复核。
    - .xlsm 保留 VBA 项目,但不扫描、不修改宏代码。
  7. 公式与单元格类型:
    - 公式表达式在 scan/verify 中会扫描;anonymize 不改写公式。若公式中检出敏感值,流程会拒绝生成可能残留敏感值的输出文件。
    - 数字、日期、布尔值单元格默认不修改,以免破坏类型与格式;若相邻字段规则在这类单元格中检出敏感值,anonymize 会失败而不是写出含残留敏感值的工作簿。若要替换这类值,可先把目标列转为文本,或导出为 CSV/TSV 再处理。

安装与启用

Skill 遵循通用 SKILL.md 格式。在已具备 SkillHub CLI 的前提下,安装到当前 Agent 能识别的 skills 目录(安装时必须指定 --dir,否则默认落在 ./skills/ 且可能不被客户端加载)。

  1. 检查 CLI:
command -v skillhub && skillhub --version
  1. 若未安装,可按 SkillHub 安装文档执行完整安装或仅 CLI(沙箱环境需允许联网):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
  1. 安装本 Skill(将 <skills 目录> 换成当前环境路径):
skillhub install @user_c0e4b78f/anonymize-sensitive-files --dir <skills 目录>

常用客户端 skills 目录(摘自 SkillHub 安装说明):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装后按各客户端要求刷新或重启,使 Skill 被加载。SkillHub 页面亦提供自然语言安装提示:让 Agent 根据 SkillHub 安装文档 安装 @user_c0e4b78f/anonymize-sensitive-files。

典型用法

在 Skill 已启用的情况下,常见做法是让 Agent 对指定文件执行官方描述的三类操作:

  1. scan:检出敏感项并输出 JSON 报告,用于确认范围和规则是否合适。
  2. verify:在含公式等复杂内容时复核是否仍有敏感值(例如公式表达式中的字面量)。
  3. anonymize:在通过校验策略后生成脱敏副本;若公式或受保护单元格类型中仍含敏感值,流程会中止而不是写出不安全文件。

对话侧可明确文件路径、是否需要自定义敏感词表,以及是否只扫描、还是直接脱敏。Excel 场景可说明表头与值的布局(相邻单元格或「列头在上」),以便相邻字段规则生效。

适用场景与注意

适合:需要在共享、评审或训练素材准备前,对 Markdown、DOCX、Excel 等业务文档做结构化脱敏;希望保留版式、且用一致假名/假号维持可读性的团队。

注意:

  • Excel 中非字符串单元格与公式相关限制见上文;复杂对象(图表、嵌入对象等)脱敏后应人工抽查。
  • .xlsm 宏代码不在扫描与改写范围内,不能假定宏或隐藏层已去敏。
  • SkillHub 统计(以抓取资料为准):分类 ai-agent,评分 100000,下载 2165 次;安装数在元数据中可能为 0,以页面实时数据为准。

结尾

「敏感文件脱敏 Skill」把扫描报告、一致性假数据替换和 Excel/DOCX/Markdown 结构保留写进 Agent 工作流,适合在对外发文档前做可复核的本地脱敏。官方 Skill 页与 API 入口:

  • https://www.skillhub.cn/skills/user_c0e4b78f/anonymize-sensitive-files
  • https://api.skillhub.cn/user_c0e4b78f/anonymize-sensitive-files
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye