用途:审查一个 agent skill,分三层进行——自动 lint(硬规则)、上下文发现项评估(由 agent 结合上下文判断)、结构化语义评审(对照最佳实践深度分析)。可选修复问题,并通过独立子代理验证修复结果。
主要能力:
- 自动 lint:运行 python3 {SKILL_DIR}/scripts/validate.py run --path <skill-path>,输出硬规则判定(linter 等级)与需人工判断的软性发现项。
- 画像提取:运行 bash {SKILL_DIR}/scripts/analyze.sh analyze <skill-path>,识别 skill 级别(l0/l0plus/l1)与功能标志。
- 上下文发现项评审:依据 context_hint 判断每条发现项,真实问题升级为 warning,其余驳回并附简短说明。
- 语义评审:完整阅读 SKILL.md,对 6 个维度各打 0-3 分——5.1 描述质量、5.2 工作流设计、5.3 运行时健壮性(仅 L0+/L1)、5.4 脚本质量(仅含脚本时)、5.5 UX 实践、5.6 安装流程完整性,总分 18。
- 报告与改进建议:按固定格式输出 linter 等级、失败/警告、发现项处理结果、各维度评分与改进建议(含改什么、改哪个文件、前后示例、优先级)。
- 修复与验证:用户可选全部修复、挑选修复或跳过;修复后不得自评,须派发独立子代理重新运行工具并独立打分,最多 3 轮修复-验证循环。
使用方式:接受包含 SKILL.md 的目录路径,若当前工作目录含 SKILL.md 则自动检测。按 Step 1 识别 skill、Step 2 评审、Step 3 呈现发现、Step 4 修复门、Step 5 验证迭代执行。
限制:验证必须独立,禁止修复者自评、禁止复用同一子代理复验、禁止未跑工具先修复、禁止忽略验证报告;超过 3 轮仍有问题则报告剩余问题交由用户决定。linter 等级 A 且语义分 ≥15 时建议用 better-skill-publish 发布。具体安装方式、收费与平台支持暂未提供。