前言¶
合同、客户清单、财务表和内部报告在对外共享前,往往需要去掉姓名、证件号、银行卡和机构名称。手工查找替换容易漏项,统一改成 [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 官方说明,可按工作流理解为「扫描 → 校验 → 脱敏」:
- 扫描与报告:扫描敏感信息并生成 JSON 报告。
- 安全输出:生成脱敏副本,不覆盖原文件。
- 替换策略:用真实感假数据替换原值,而非简单写成
[REDACTED];同一次运行中,相同原值映射为相同假值,便于对照结构。 - 词表:支持自定义敏感词表。
- 表格与 Excel 字段规则:
- Markdown 表格、DOCX 表格、Excel 工作表支持相邻字段,例如A1=法定代表人、B1=某姓名。
- Excel 还支持列头在上、值在下的规则,例如A1=姓名、A2=某姓名。 - Excel 与宏相关:
- 处理范围包括工作簿属性、工作表名、字符串单元格、hyperlink 的文本与目标;尽量保留工作簿、样式、隐藏表和宏。
- 批注、图片、图表、文本框、透视表、嵌入对象和宏代码需额外人工复核。
-.xlsm保留 VBA 项目,但不扫描、不修改宏代码。 - 公式与单元格类型:
- 公式表达式在 scan/verify 中会扫描;anonymize 不改写公式。若公式中检出敏感值,流程会拒绝生成可能残留敏感值的输出文件。
- 数字、日期、布尔值单元格默认不修改,以免破坏类型与格式;若相邻字段规则在这类单元格中检出敏感值,anonymize 会失败而不是写出含残留敏感值的工作簿。若要替换这类值,可先把目标列转为文本,或导出为 CSV/TSV 再处理。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在已具备 SkillHub CLI 的前提下,安装到当前 Agent 能识别的 skills 目录(安装时必须指定 --dir,否则默认落在 ./skills/ 且可能不被客户端加载)。
- 检查 CLI:
command -v skillhub && skillhub --version
- 若未安装,可按 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
- 安装本 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 对指定文件执行官方描述的三类操作:
- scan:检出敏感项并输出 JSON 报告,用于确认范围和规则是否合适。
- verify:在含公式等复杂内容时复核是否仍有敏感值(例如公式表达式中的字面量)。
- 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