Agent Skills
返回列表
Skill脱敏检查

Skill脱敏检查

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,将 @user_c6886734/skill-prepublish-security-scan 安装到 AI 助手中。

技能介绍

解决什么问题

技能包通常会被提交到仓库、发布到市场或分享给第三方,而目录里往往混着不该被带走的东西:config.py 里残留的真实 API Key、curl 命令中的 Authorization 头、演示用的 .env 副本、注释里随手粘贴的 Webhook URL。等到敏感信息泄露再追查,成本远高于上线前的一次扫描。这个技能的作用就是在发布前对技能目录做一次全量的敏感信息自检,让「有没有泄露风险」这个问题有确定答案。

工作原理

技能的核心是一个扫描脚本 scripts/security_scan.py,覆盖四大类敏感信息。

  • 开发者与系统凭证:AWS、GitHub、Slack、Stripe、Twilio 等服务的 Key 与 Token,PEM 私钥块,带账号密码的数据库连接串,以及硬编码的 secret_key。
  • PII(个人身份信息):邮箱、中国手机号、18 位身份证号、护照号、SSN、国际电话。
  • 财务数据:信用卡号(经 Luhn 算法校验)、CVV、比特币与以太坊钱包地址。
  • 运行日志与用户输入:堆栈跟踪、console.log 中的敏感变量、Session ID、内网 IP 等隐性泄露点。

关键步骤:

  1. 通过 SKILL.md 定位待检查目录;
  2. 运行扫描,--lang en 或 --lang zh 控制报告语言;
  3. 退出码表达结论:0 通过、1 需关注、2 扫描器错误;
  4. 报告按严重程度分级:CRITICAL 与 HIGH 必须清零,MEDIUM、LOW 酌情处理;
  5. 需要批量清理时用 --mask 自动脱敏,然后重新扫描验证。

边界与注意点

  • --mask 是直接改文件的危险操作,跑之前先备份;
  • 扫描器自动过滤 example.com、test.org 等安全域名的邮箱,也会自动去重重叠命中,这些是设计预期,不是漏检;
  • 扫描器看不见的地方仍需人工复查:Base64 编码后的敏感信息、SKILL.md 代码块里的真实 Token、scripts/ 中残留的调试语句。发布前人工核对清单仍是必要环节。

使用场景

  • 准备将 Skill 发布到 marketplace 前,运行扫描脚本对 `SKILL.md` 旁边整个目录做敏感信息预检,确认无 CRITICAL 级密钥。
  • 收到他人提交的 Skill 文件包,轮到你审核上架安全,用它跑一遍字典里的四类敏感信息规则,生成分级报告留档。
  • 刚修完一组硬编码的 API Key,想确认 `config.py`、`.env` 和 `SKILL.md` 代码块中的残留是否真的清零,跑一次退出码 `0` 的验证扫描。
  • 合并新贡献者的 PR 前,对 `scripts/` 与 `references/` 目录执行扫描,排查容易被忽略的护照号、Webhook URL 和内网 IP。

适合人员

  • 发布技能到第三方市场的独立开发者,需要确保 `SKILL.md` 示例和配置文件里不残留真实 Token 或数据库连接串。
  • 运营技能商店的审核人员,需要在上架前对海量提交做合规性过滤,降低平台侧的法律与舆情风险。
  • 维护团队内部 Skill 仓库的 DevOps 工程师,需要给 CI 阶段接入一段可脚本化的敏感信息自检,防止 PR 里混入私钥。