pii-checker
使用 agent-sec-cli 检查文本、UTF-8 文件或日志中的个人信息与凭证,报告脱敏证据,并按需生成脱敏文本。当用户要求检查敏感信息、查找泄露的密钥或对内容脱敏时使用;查询已发生的安全事件使用 security-observability。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 665
- Forks
- 195
01 前言 Front Matter
- name
- pii-checker
- description
- 使用 agent-sec-cli 检查文本、UTF-8 文件或日志中的个人信息与凭证,报告脱敏证据,并按需生成脱敏文本。当用户要求检查敏感信息、查找泄露的密钥或对内容脱敏时使用;查询已发生的安全事件使用 security-observability。
03 SKILL.md 正文
PII Checker
复用已安装的 agent-sec-cli scan-pii 检测个人信息和凭证。
V2 需要预先运行的 Rust daemon 和 AGENT_SEC_DAEMON_SOCKET;不自动启动或回退到 Python。
支持邮箱、中国手机号、身份证号、银行卡号、API Key、Bearer Token、JWT、
私钥及自定义规则。仅检查用户指定的内容,不主动扩大到整个目录或历史会话。
调用
已知文件路径时直接扫描文件,无需先将原文读取到对话中:
agent-sec-cli scan-pii --input /absolute/path/to/input.txt --source manual --format json
用户要求脱敏时追加 --redact-output:
agent-sec-cli scan-pii --input /absolute/path/to/input.txt --source manual --format json --redact-output
内容来自文本或上游工具时,通过工具的标准输入接口或已有数据流传给下面的命令; 不要启动无人提供输入的交互式读取:
agent-sec-cli scan-pii --stdin --source manual --format json
--input只接受单个 UTF-8 文本文件,不解析目录、PDF、图片或压缩包。--input、--stdin、--text三者必须且只能选一个。敏感正文优先走文件或 stdin,避免放入命令参数;不要将待扫描文本拼接为 shell 代码。- 替换路径时优先使用参数数组;必须经 shell 时,对整个路径使用可靠的 shell
quoting(例如
shlex.quote),不能只在任意路径两侧加单引号。 - 普通主动检查使用
--source manual。此标签用于审计,不会更改输入或 Hook 策略。 --include-low-confidence可用于用户要求的更广泛复核,包含默认被过滤的低置信度 命中;这些分值是启发式评分,不是经过校准的概率。- 默认扫描完整输入。只有明确限定范围时才设置正整数
--max-bytes,并报告截断。 - CLI 不可用、不支持
scan-pii、输入不可读或命令失败时,报告未完成检查; 不以模型自行猜测代替扫描结果,不安装软件或更改安全配置来绕过失败。
解释结果
解析 JSON 的 ok、verdict、summary、findings;不能只看退出码。
warn 和 deny 也可能返回退出码 0,表示扫描完成。
| 字段 / 值 | 解释与处理 |
|---|---|
ok=false 或 verdict=error |
扫描失败,本次未完成检查 |
verdict=pass |
在本次规则、置信度过滤和扫描范围内未检出问题 |
verdict=warn |
存在告警级命中,没有 deny 级命中 |
verdict=deny |
存在 deny 级命中;这是扫描判定,不代表已经阻断或撤销凭证 |
summary.truncated=true |
只扫描了部分输入,不能给出全文结论 |
summary.findings_truncated=true |
返回的命中明细或证据有省略;使用 summary.total / summary.by_type 报告统计,不能将返回的 findings 当作完整位置清单 |
summary.redacted_text_omitted=true |
响应省略了完整脱敏正文;redacted_text 是整段占位符,不能作为完整脱敏产物使用 |
summary.custom_rules.status=invalid |
自定义规则未生效,内置规则的结果仍可报告 |
summary.custom_rules.runtime_error_count>0、budget_exhausted=true 或 truncated=true |
自定义规则执行或结果不完整,必须说明覆盖限制 |
未配置自定义规则(status=absent)是正常状态,不算扫描失败。
JSON 缺失、解析失败、关键字段缺失或出现未知 verdict 时,报告无法取得有效判定。
pass 只表示未检出,不能承诺不存在敏感信息或内容可以安全外发。
报告实际扫描范围、判定、summary.total / summary.by_type 的命中统计,
必要时列出 finding 的 type、severity、span 和 evidence_redacted。
不要使用 --raw-evidence,也不要从原文或对话历史补回已脱敏的值。
脱敏与审计
只在用户要求脱敏时返回 redacted_text,并先检查 summary.redacted_text_omitted。
该标记为 true 时,即使扫描成功且覆盖完整,也没有可交付的完整脱敏正文;
应说明输出大小限制,并报告扫描判定与统计。不得把 [REDACTED: output size limit]
占位符作为完整脱敏文本交付、保存或覆盖原文件,也不要用省略后的 findings 重建全文。
该标记为 false 或不存在时,redacted_text 在实际扫描范围内替换检出的内容。
如果扫描或自定义规则不完整,要说明脱敏结果也不完整,不能把截断的片段当作全文。
--redact-output 不修改原文件;仅在用户要求保存或替换文件时执行对应写入。
扫描会记录经过脱敏的 pii_scan 安全事件。此 Skill 不调整 Hook 开关、阻断策略
或自定义规则配置;历史安全事件的查询与复盘由 security-observability 处理。
04 同仓库更多 Skills
ws-ckpt
Linux 工作区快照(ws-ckpt)。用户想保存或备份工作区当前状态("保存一下"、"留个底"、"先备份"), 想撤销或恢复文件改动("回滚"、"撤销"、"改回去"、"恢复到之前"、"刚才那版"), 想查看、对比或删除历史版本,或要开启/关闭每回合自动快照、定时快照、快照保留策略时使用。 用户没提"快照"、只表达保存或恢复工作区文件的意图时同样适用;用户点名 git 操作(commit、branch、reset 到某提交)时不适用。
skillfs-mount
Help users configure, mount, and unmount a skillfs FUSE virtual filesystem on their local machine (e.g. for openclaw). Covers analyzing existing skill usage to suggest view configuration, generating skillfs-views.toml, mounting, and graceful unmount. Use this skill when the user asks to: set up skillfs, configure skill views, mount or unmount skillfs, check if skillfs is running, or get help organizing their skills directory (especially for openclaw users).
test-skill
A test skill used in integration tests.
storage-resize
Linux 磁盘扩容技能(RPM 包管理系统),实现云盘扩容后自动完成分区调整和文件系统扩容。支持系统盘/数据盘在线扩容,适配 XFS/EXT4/Btrfs 文件系统。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)。
ktuner
内核参数自动调优。分析系统配置,输出调优建议并可一键应用,支持自动回滚。使用场景:系统性能优化、安全加固、内核参数诊断。
backup-restore
处理所有备份与恢复任务,覆盖四个层面:工作区(项目/数据库/代码)、用户数据(家目录/dotfiles/密钥)、操作系统(全量系统/磁盘镜像/LVM 快照)、阿里云快照(云盘快照/自动策略/跨地域复制/整机镜像)。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)纯命令行环境,使用 yum 包管理器。当用户提到备份、恢复、快照、归档、回滚、克隆、迁移、容灾等任何涉及数据保存或恢复的请求时触发此技能,即使请求看起来很简单也应使用。