技能介绍

为什么需要技能审计

Agent 技能往往以 Codex 同类权限运行：一条有漏洞的 SKILL.md 或附带脚本，可能触发删文件、eval/exec、外连 API，或把 API Key 写死在正文里。体积过大的技能还会占满上下文窗口，让模型在真正任务上变「笨」。维护成本高、结构混乱时，问题更难在上线前被发现。

技能如何工作

Skill Auditor Plus 把审计拆成三条可重复的流水线，并输出带严重级别的报告。

安全审计

自动扫描：危险操作（如 rm -rf、系统命令、任意代码执行）、凭证泄露（硬编码密钥/令牌/密码）、外网请求、可疑链接（短链、Pastebin）、路径与注入风险。严重度分为高/中/低，便于按优先级处理。

性能审计

对照可量化阈值：frontmatter 建议 <100 tokens，正文 <5000 tokens，总行数 <500，单份 reference 建议 <10k tokens。同时检查重复内容、未引用文件、脚本重复与 references/ 渐进披露是否合理。

质量审计

检查 SKILL.md frontmatter 与说明是否完整、目录是否夹杂多余文档（如多余的 README.md）、用法示例与错误处理是否清晰。

典型用法：安装前审一遍、开发中持续审、对已安装技能批量扫。报告侧建议：凭证改环境变量；危险操作加约束或显式警告；正文过长则拆到 references/ 并在主文件做导航。

适用边界与注意点

安全规则基于模式匹配，误报可能出现；需在代码旁注释说明安全性，或重构避开触发模式。
复杂技能正文偏大是常态，审计的价值在于推动拆分，而不是追求「一次通过」的形式主义。
阈值与自定义安全模式可通过 scripts/security_audit.py、scripts/performance_audit.py 调整；更完整的规范见 references/best-practices.md。
依赖未装齐时可能出现 Module not found，需先补齐运行环境再解读报告。