这是什么

「要不要装这个技能」应该有一个结构化、可回溯的决策依据，而不是凭感觉。元审把安装前审查固化成四阶段 checklist（来源 → 代码 → 权限 → 风险），并用轻量 checker 自动扫描危险模式、输出 SKILL VETTING REPORT。它不是某个平台的专属功能，而是一份与智能体无关的审查协议：装进任何支持 Agent Skills 的智能体即可按需调用，只做初审与报告，绝不代替最终决策。

核心价值

• check：四阶段初审（来源/代码/权限/风险），输出 SKILL VETTING REPORT（结论/决策记录/时间戳/审查者）。
• source：GitHub 仓库来源半自动化检查（stars/更新时间/许可证），本地缓存，无网络自动降级。
• 规则共用：危险模式规则与元安同源（scripts/vetter_rules.py 为 audit_rules.py 的同步副本）。
• 联动元安：初审发现 high 及以上，输出一条命令引导跑元安深度扫描。
• 结论分级：critical=DO NOT INSTALL；high=INSTALL WITH CAUTION；medium=REVIEW REQUIRED；low/info=SAFE TO INSTALL。

核心优势

| 优势 | 说明 | |---|---| | 四阶段结构化 | 来源→代码→权限→风险，逐环核对，缺一不可 | | 结论可回溯 | 报告含结论/决策记录/时间戳/审查者，留痕可追责 | | 规则与元安同源 | vetter_rules.py 为 audit_rules.py 同步副本，口径一致 | | 来源半自动 | source 命令查 stars/更新时间/许可证，本地缓存、无网络自动降级 | | 联动深度扫描 | high 及以上自动引导跑 yotta-security-audit | | 零依赖 | Python 3.8+ 标准库，无 daemon / 无数据库；Windows + Linux 通用 | | 生态分发 | GitHub + npm 双源同步发布；npx / git clone / Download ZIP / install.sh 四种安装方式 |

功能体系 / 四阶段审查协议

| 阶段 | 检查点 | 对应命令/参考 | |---|---|---| | 1. 来源 | 来源平台、作者信誉、stars/更新时间、许可证 | source github:owner/repo；references/checklist.md | | 2. 代码 | SKILL.md 完整性、脚本清单、危险模式规则扫描 | check | | 3. 权限 | 可执行位、全局可写、符号链接、需读取/写入/联网的范围 | check | | 4. 风险 | 风险等级判定 + 结论 + 决策记录 | 报告中的 结论/决策记录 段 |

结论判定

| 风险等级 | 结论 | 动作 | |---|---|---| | critical | DO NOT INSTALL | 拒绝安装并人工复核 | | high | INSTALL WITH CAUTION | 人工复核后决定 | | medium | REVIEW REQUIRED | 复核后安装 | | low/info | SAFE TO INSTALL | 仍建议按协议完整审查 |

使用示例

# 初审一个技能目录
python3 scripts/yotta_vetter.py check ./some-skill

# 输出 JSON + 生成报告文件
python3 scripts/yotta_vetter.py check ./some-skill --json --report report.md

# 只报告 high 及以上
python3 scripts/yotta_vetter.py check ./some-skill --severity high

# 来源半自动化检查（本地缓存，无网络自动降级）
python3 scripts/yotta_vetter.py source github:YottaMeta/yotta-memory

exit code 语义：0 = 干净 / 仅 low；1 = medium；2 = high；3 = critical；4 = 错误。

与元安的分工

• 元审 = 初审：快、轻，四阶段 checklist + 规则扫描 + 来源检查。
• 元安 = 深度扫描：13 类检测器 + 系统安全基线。
• 元审发现 high 及以上 → 输出命令引导跑元安深度扫描。

安装

以下四种方式任选，顺序即推荐优先级；技能文件一律从 npm 获取（GitHub 无代理较慢，npm 支持镜像）。

方式一：npm 一行装（推荐）

# 可选国内加速：npm config set registry https://registry.npmmirror.com
npx -y @yottameta/yotta-vetter --agent <智能体名称>      # 装到指定智能体默认用户级技能目录
npx -y @yottameta/yotta-vetter --dir <智能体的技能目录>  # 指到技能目录本身（如 ~/.codex/skills）

• --agent <name> 自动装到该智能体默认用户级目录；--list 可查看各智能体默认目录。
• --dir <路径> 装到指定的技能目录；未收录的智能体用 --dir 指到它的技能目录。
• npmmirror 未同步新包（404）：加 --registry=https://registry.npmjs.org/（国内需代理），或稍等镜像缓存。

方式二：git clone（开发者 / 有 git 环境）

git clone https://github.com/YottaMeta/yotta-vetter.git <智能体的技能目录>/yotta-vetter

方式三：GitHub 下载压缩包（手动 / 无 git 环境）

在 GitHub 仓库 YottaMeta/yotta-vetter 点 Code → Download ZIP，解压后把 yotta-vetter 文件夹放进智能体技能目录。

方式四：install.sh（多智能体一键脚本）

bash install.sh --agent <name>   # 装到指定智能体默认用户级目录
bash install.sh --dir <path>     # 装到指定目录
bash install.sh --list           # 列出智能体 -> 默认目录

方式一走 npm 源（npmmirror / npmjs），不依赖 GitHub；方式二 / 三走 GitHub，国内无代理可能失败。

升级 / 卸载

• 升级：重新安装最新版覆盖即可——重跑你用的安装命令（如 npx -y @yottameta/yotta-vetter --agent <name> 或 bash install.sh --agent <name>）。技能目录内旧文件会被替换；不影响项目中其他文件。
• 卸载：删除目标智能体 skills 目录下的 yotta-vetter 文件夹（各智能体目录见上表）即可。卸载后本技能不再生效。

常见问题

• 元审能直接替我做决定吗？ 不能。checker 只做初审与报告，最终结论必须由人类确认。
• 发现 high 风险怎么办？ 报告会输出一条引导命令跑元安（yotta-security-audit）深度扫描；建议先隔离或停止使用该技能，再人工复核。
• 离线能用吗？ 能。source 里 GitHub API 检查在无网络时自动降级；check 完全本地运行。
• 我自己扫自己会误报吗？ 元审自身含 source 检查，用标准库 urllib 访问 GitHub API，自扫会命中网络调用提示（medium），属预期行为，非风险。

相关技能

同属 YottaMeta 技能矩阵（安全家族）：yotta-security-audit（元安，13 类检测器 + 系统安全基线）负责深度扫描，元审负责安装前初审——元审发现 high 及以上会引导跑元安；yotta-memory（元忆）负责跨会话长期记忆。

开发与校验

本项目内运行：python tools/validate-skill.py yotta-vetter。

许可证

MIT © YottaMeta —— 详见 LICENSE。品牌声明见 NOTICE。来源声明：本技能由 YottaMeta 全新实现（零依赖自研 + 中文教学）。