SuperAPI AI 工具集

skill-doctor

部署与运维

查看项目

更新于 10-15 19:57

技能介绍

用途:OpenClaw 在启动时加载技能,若技能因 frontmatter 损坏、cron 表达式错误或 STATE_SCHEMA 不匹配而加载失败,会从注册表中静默消失,代理端不报错。Skill Doctor 对所有已安装技能做完整诊断,报告会导致静默不加载的所有故障。

主要能力:每个技能执行 6 项检查——YAML 解析、必填字段(name/description)、路径约定(目录名与 name 字段一致)、cron 格式(5 字段)、有状态一致性(stateful: true 时需存在 STATE_SCHEMA.yaml)、schema 有效性(含 version 与 fields)。输出分 PASS(可正确加载)、WARN(可加载但有非关键问题)、FAIL(无法加载,必须先修复)。

使用方式:python3 doctor.py --scan 做完整诊断;--scan --only-failures 仅显示 FAIL;--scan --skill <名称> 检查单个技能;--fix-hint <名称> 输出可操作的修复建议;--status 查看上次扫描摘要;--format json 输出机器可读结果。流程为扫描、优先处理 FAIL、检查 WARN、修复后重扫确认、结果写入状态。可加入 install.sh 末尾作为安装后门禁。

状态:结果持久化于 ~/.openclaw/skill-state/skill-doctor/state.yaml,含 last_scan_at、skills_scanned、fail_count、warn_count、violations。干净安装后两个计数应为 0。

限制:Skill Doctor 不修改技能文件,仅提示需改动之处;其余限制暂未提供。