OpenClaw Skill Auditor

扫描所有已安装的 OpenClaw skill，原样列出每一个命中项，由主人决定如何处理。

核心原则：你不做真实性判断。扫到什么就报什么，判断权在主人。

Overview

The auditor runs scripts/scan.py, which automatically discovers and scans all OpenClaw skill directories:

1. <workspace>/skills — workspace-level (reads from ~/.openclaw/openclaw.json)
2. ~/.openclaw/skills — user-managed skills
3. ~/.agents/skills — legacy path used by the npx skills CLI

Skills with the same name across paths are deduplicated (first occurrence wins). The script skips content inside markdown code fences to reduce documentation false positives.

Workflow

Step 1: Run the scanner

python3 ~/.openclaw/skills/openclaw-skill-auditor/scripts/scan.py \
  --out /tmp/openclaw-audit.json

Additional path: append --extra-root /path/to/skills.

Step 2: Read and render

Read /tmp/openclaw-audit.json and print the report exactly as specified below. Do not add commentary, do not filter flags, do not explain away findings.

Step 3: Terminal report format

Header:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Skill Auditor 扫描报告
扫描时间：<scanned_at>
共扫描 <skill_count> 个 skill — <flagged_count> 个有命中项，<clean_count> 个无命中
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

每个有命中的 skill，按此格式输出：

【N】<skill-name>  (<source_root>)

  🔴 安全问题
    · [严重] <rule> — <file> 第 <line> 行，共 <count> 处
      <detail>

  🟡 Token 消耗
    · [中] <rule> — <file> 第 <line> 行，共 <count> 处
      <detail>

  🟠 隐性消耗
    · [高] <rule> — <file> 第 <line> 行，共 <count> 处
      <detail>

级别对应：critical→严重 / high→高 / medium→中 / low→低
维度对应：security→🔴 安全问题 / token_bloat→🟡 Token 消耗 / hidden_cost→🟠 隐性消耗

正常 skill：

✅ 以下技能无命中（<clean_count> 个）：
   skill-a、skill-b、skill-c ...

Step 4: 让主人决定

以上 <N> 个技能有命中项，需要删除哪些？
请输入编号（如：1 3），或直接回车跳过：

不要在问题前加任何分析或建议文字。

Step 5: 安全删除

根据选中编号的 source_root + skill 名拼出完整路径，执行：

trash <skill-path>

若 trash 不可用：mv <skill-path> ~/.Trash/

禁止 rm -rf。 每删一个输出确认，删完后提示可重新扫描。

---

三个检测维度

安全（sec-*）

规则	检测内容
sec-eval	eval()
sec-exec	child_process / subprocess / os.system
sec-exfil	网络请求（fetch/axios/curl/wget）
sec-cred	.env、id_rsa、API key、钱包文件等
sec-obfuscate	base64/十六进制链式解码
sec-prompt-inject	不可见字符、同形字、越狱指令
sec-dynamic-import	运行时路径动态 import/require

Token 消耗（tok-*）

规则	检测内容
tok-skill-size	SKILL.md 超过 500 行
tok-agents-embed	引用 AGENTS.md / CLAUDE.md / MEMORY.md
tok-duplicate-rules	指令块重复 ≥3 次
tok-ref-size	references/ 单文件超过 300 行
tok-wide-trigger	触发词过于宽泛

隐性消耗（hid-*）

规则	检测内容
hid-heartbeat-abuse	指示加入 heartbeat 定时任务
hid-cron-plant	植入 cron/launchd/systemd 定时任务
hid-self-reinstall	npx skills add 自我复制
hid-always-load	要求每次会话预加载
hid-tool-spam	注册超过 10 个 MCP 工具
hid-bg-process	nohup/pm2/forever/daemon 后台持久进程
hid-infinite-loop	while True / while(true) 无限循环
hid-set-interval	setInterval 或递归 setTimeout
hid-websocket	WebSocket 长连接
hid-sleep-loop	sleep 调用（常与循环结合实现轮询）

---

注意事项

• 扫描时自动跳过 openclaw-skill-auditor 本身。
• scan.py 会跳过 markdown 文件中的代码块内容，以减少文档示例触发的误报。
• 若 scan.py 执行失败，直接报告错误命令和原因。
• 禁止在报告中加入"判断"、"这属于正常行为"、"可以忽略"之类的文字。扫到什么列什么，主人决定要不要删。