用途：HIG Doctor Audit 是 Apple HIG 相关工作的验证循环，与 hig-* 参考技能互补。先运行审计找出具体问题，再用匹配的 HIG 技能与参考主题修复。适用于用户要求 HIG 审计、Apple UI 合规扫描等场景。
工具：HIG Doctor 文档位于 https://apple.raintree.technology，以 hig-doctor 名称发布。命令示例：npx hig-doctor ./path/to/project；npx hig-doctor ./path/to/project --export；npx hig-doctor ./path/to/project --stdout；npx hig-doctor ./path/to/project --json；npx hig-doctor ./path/to/project --fail-on critical。已发布包需要 Node 20+。从本地源码仓库运行，Bun 入口点为：cd /path/to/hig-doctor/packages/hig-doctor/src-termcast，然后 bun run audit ./path/to/project。
工作流：确认项目路径与目标平台/框架；运行 npx hig-doctor <path> --export 生成可读的 hig-audit.md，或 --json 用于 CI/脚本；输出较大时，优先处理 critical、serious，再到高置信度的 moderate；将各 category 的 skill 字段映射到匹配的本地 HIG 技能（如 hig-foundations、hig-components-controls）；只读取针对该问题所需的特定 HIG 参考主题；修复具体代码问题后用相同参数重跑审计；CI 中先用 --fail-on critical，清理完现有 serious 问题后再提升到 serious。
忽略文件：使用 .higauditignore 处理有意的夹具、生成输出、stories 或演示，例如 **/*.stories.tsx、examples、components/audit-demo-fixtures.ts。保持忽略范围窄，不要为让审计通过而隐藏应用 UI 代码。
结果解读：critical 为破坏无障碍或阻断交互，除非明显误报，否则视为发布阻塞项；serious 为显著的 HIG 或 UX 降级，发布可见 UI 前修复；moderate 为风格或最佳实践偏差，在设计系统中重复出现时批量处理；positive 为有用证据，非待办工作。HIG Doctor 基于正则表达式，编辑前需对照代码与相关 HIG 参考核实每条发现。