用途：审计本地 Agent Skills 目录或已安装技能根目录，检查元数据与文档链接问题，并可选执行保守修复。需 PATH 中存在 ai-skillet 1.0.0 或更新版本，运行 ai-skillet doctor；可附加选项如 --root PATH（可重复，默认当前目录）、--skill NAME（可重复）、--format text|json（默认 text）、--fix-safe、--dependencies-only（不可与 --fix-safe 同用）。
主要能力：校验可移植 Agent Skills 字段、Claude Code 扩展与仓库扩展的并集，报告未知顶层字段、无效类型或枚举值、agent 或 background 缺少 context: fork 等。报告提示卫生警告（陈旧模型固定、超大无条件 Markdown 引用、需求/禁止冲突、缺少完成证据），仅建议不自动修复。依赖错误拒绝非数组、空、非字符串、重复、格式错误、顺序错误、自引用或未解析的本地声明；外部 ORG/REPO#SKILL 仅做形状检查。错误视为阻塞发布或同步的目录缺陷，警告需人工复核。
使用方式：读取发现后再执行安全修复：ai-skillet doctor --root . --fix-safe；手动修改后不带 --fix-safe 重跑。仅依赖检查：ai-skillet doctor --root . --dependencies-only。JSON 输出为 schema 版本 1，含 roots、计数、findings 与安全修复记录，每项含代码、严重级别、路径、行号、可修复性与消息。
安全修复策略：只创建缺失的 agents/openai.yaml（policy.allow_implicit_invocation 由 SKILL.md 推导），或更新与 disable-model-invocation 不一致的布尔值；暂存后原子重命名，更新时保留权限，失败退出 3 且不部分改写。不重写 frontmatter、描述、README 行、references/version.txt 或相对链接；未知字段、无效类型、跨字段错误与协调声明仅报告，需手动修改。
限制：只审计传入的根目录，不搜索技能安装位置；查找安装、重复与交叉引用请用 ai-skillet map。退出码：0 干净或修复成功无发现；1 审计完成但仍有发现；2 参数无效或环境不可读；3 安全修复失败。JSON 输出须保持字节有效且不加装饰。