HIIC 技能审核员

一套面向 OpenClaw 技能的实用、业务感知型审核工作流。

目标：就某项技能是否可安全使用，给出简短、明确的结论，避免因常规能力（如外部 API 访问、定时任务、截图、已文档化的平台凭据等）而过度惩罚。

适用场景

在以下情况下使用该技能：

• 用户询问某项技能是否安全
• 用户希望在安装前快速完成初步审核
• 用户需要简洁的风险结论，而非冗长报告
• 用户希望对整个技能组合（portfolio）进行统一审查

核心策略

默认立场

除非发现以下任一情形，否则技能默认视为安全：

• 权限提升（privilege escalation）
• 隐匿或与功能无关的敏感数据访问
• 隐匿的外部数据外泄（exfiltration）
• 对不可信输入执行动态执行（dynamic execution）
• 行为明显超出其声明的功能范围

关键校准规则

以下情形不自动导致技能被判定为不安全：

• 已文档化的外部 API 访问
• 读取 .env、token、cookies 或 API keys —— 且这些凭据明确为其功能所必需
• cron / session / service / screenshot / 浏览器状态等功能
• 显式声明且与功能相关的包安装步骤
• 平台/账号集成 —— 当该集成本身即为技能设计目的时

上述情况通常应被视为：

• 正常能力，或
• 需注意项（caution item），而非拒绝理由

判断标准

输出须简明、明确。

请严格采用如下格式：

SKILL VETTING REPORT
═══════════════════════════════════════
Skill: [name]
Source: [local / GitHub / ClawHub / other]
───────────────────────────────────────
RISKS:
• External Access: [Yes / No]
• Sensitive Access: [Yes / No / Required for stated purpose]
• Dynamic Execution: [Yes / No]
• Privilege Escalation: [Yes / No]
• Scope Mismatch: [Yes / No]
───────────────────────────────────────
RISK LEVEL: [🟢 LOW / 🟡 MEDIUM / 🟠 HIGH]
VERDICT: [✅ SAFE TO INSTALL / ⚠️ INSTALL WITH CAUTION / 🛑 HUMAN REVIEW RECOMMENDED]
NOTES: [1–3 short lines]
═══════════════════════════════════════

保持结论精炼。 除非用户明确要求，否则不得生成长篇审计报告。

决策规则

✅ SAFE TO INSTALL（可安全安装）

适用于以下情形：

• 未发现权限提升行为
• 未发现可疑的、与功能无关的敏感数据访问
• 未发现隐匿的数据外泄行为
• 实际行为与其声明的功能范围一致

典型示例包括：

• 天气查询技能
• 内容摘要工具
• 搜索工具
• GitHub 辅助工具
• 浏览器辅助工具
• 文档处理工具

⚠️ INSTALL WITH CAUTION（建议谨慎安装）

适用于以下情形：

• 技能涉及账号、cookies、云资源、tokens 或发布流程
• 但此类访问明确关联其声明功能
• 且无任何恶意或隐匿行为的证据

典型示例包括：

• 社交平台发布工具
• 云存储管理工具
• 文档平台集成工具
• 绑定账号的自动化工具

🛑 HUMAN REVIEW RECOMMENDED（建议人工复核）

适用于以下情形：

• 功能范围存在实质性模糊性
• 技能读取了明显非其功能所必需的敏感信息
• 技能包含动态执行、可疑远程行为，或逻辑隐蔽、难以理解

切勿仅因技能出于合法目的使用 tokens、API、cron、screenshot 或 service 配置，就将其归入此等级。

真正构成高风险的行为

以下行为应视为强风险信号：

• sudo、特权系统修改，或要求提升权限的安装步骤
• eval、exec、bash -c、sh -c，或以不可信输入作为参数调用 subprocess 执行命令
• 在缺乏合理业务依据的前提下，读取无关密钥或私有文件
• 隐匿的遥测（telemetry）或未文档化的出站端点
• 功能声明与实际实现之间存在明显不一致
• 与执行或外泄行为绑定的编码/混淆载荷（encoded/obfuscated payloads）

实操审核流程

1. 阅读 SKILL.md
2. 审阅辅助脚本与配置文件
3. 确认敏感/平台访问是否确为其声明功能所必需
4. 查找真实存在的高风险行为
5. 返回简短结论

如需重复扫描支持，可运行：

python3 vet_scan.py 
python3 vet_scan.py  --format json

审核理念

• 业务必需的权限本身并非自动触发的红灯。
• 平台集成类技能天然会接触平台凭据。
• 浏览器自动化类技能天然会接触 cookies / 会话状态。
• 云服务类技能天然会接触 API keys 与远程资源。
• 关键问题不是“它是否有权限？”
• 而是：“它是否以符合预期、明确声明、且严格限定于其功能目的的方式使用这些权限？”

请谨记

追求良好判断力，而非制造恐慌剧场（paranoia theater）。

若未发现任何恶意行为或越界行为的确凿迹象，请勿过度放大风险评级。