用途：审计本地 Agent Skills 目录或已安装技能根目录，检查元数据与文档链接问题。基于 ai-skillet 的支持扩展技能方言规范验证器，先报告发现的问题，再按需执行窄范围修复。
主要能力：支持 --root PATH（可重复，默认当前工作目录）；--format text|json（默认 text）；--fix-safe 创建缺失的 agents/openai.yaml 或修正不匹配的 policy.allow_implicit_invocation；--dependencies-only 仅报告格式错误或未解析的 skill-dependencies 声明，不能与 --fix-safe 组合。校验 frontmatter 接受可移植 Agent Skills 字段、Claude Code 扩展与仓库扩展的并集，报告未知顶层字段、无效类型与枚举值，以及未搭配 context: fork 的 agent 或 background。会给出冗余默认值警告、提示卫生类建议性警告（如过时模型固定、过大无条件 Markdown 引用、需求与禁止语冲突、缺少完成证据），以及仅报告不修复的协调豁免错误与依赖错误。
使用方式：需 PATH 中有 ai-skillet 0.1.0 或更高版本。基本命令：ai-skillet doctor "$ARGUMENTS"；JSON 输出：ai-skillet doctor --root . --format json；读完成发现后再运行安全修复：ai-skillet doctor --root . --fix-safe；仅依赖门禁：ai-skillet doctor --root . --dependencies-only。手动编辑后应不带 --fix-safe 重新运行。
限制：--fix-safe 仅能创建缺失的 agents/openai.yaml 或更新与 disable-model-invocation 不一致的 allow_implicit_invocation 布尔值，不重写 frontmatter、description、README 行、references/version.txt 或相对链接；未知字段、无效类型值、跨字段错误、冗余默认值和协调声明均仅报告。退出码：0 干净或修复成功且无发现；1 审计完成但仍有发现；2 参数无效或环境不可读；3 安全修复失败。JSON 使用 schema 版本 1。external ORG/REPO#SKILL 标识仅做形状检查，无网络访问。skill-doctor 只审计传入的根目录，不搜索它们；跨机器定位技能安装与交叉引用需用 ai-skillet map。