用途:doctor 是 OrchestKit 的健康诊断技能,按名称调用即可运行。它自动检测已安装插件并对 16 个类别做检查,包括已安装插件、技能校验、智能体校验、Hook 健康、权限规则、Schema 合规、协调系统锁定、上下文预算、记忆系统、Claude Code 版本、外部依赖、MCP 状态、插件校验、effort/模型兼容性、沙箱姿态与操作者设置姿态。每次检查结论分为 pass、warn、fail,warn 或 fail 都会给出具体修复步骤,既诊断也开方。
主要能力:检测 Hook 的文件缺失、JSON 语法错误、权限问题与失效引用;校验技能 frontmatter、token 预算与激活通道;检查 MCP 的启用/禁用/配置错误与凭据;用 claude plugin validate 做官方 frontmatter 校验;检查 CC 版本是否满足 supported_floor;对 HIGH 级服务器在 .mcp.json 中解析到 @latest 给出告警;检查 macOS 沙箱拒绝事件与操作者作用域缺失的安全控制。
使用方式:doctor 做标准检查,doctor -v 输出详情,doctor --json 供 CI 使用,doctor --category=X 仅运行指定类别;也可用 doctor cc、doctor mcp、doctor plugin 限定范围,或设 ORK_DOCTOR_SCOPE 环境变量跳过交互提问。修复后 CC 2.1.69+ 可运行 /reload-plugins 生效,CC 2.1.152+ 对非插件技能可运行 /reload-skills。
适用场景:安装或更新 OrchestKit 后、Hook 未按预期触发、部署到团队环境前、调试协调问题、npm run build 之后。
限制:完整运行约 20 秒;类别 14 仅在能证明模型不支持 xhigh 时才告警,其余保持静默;沙箱日志查询仅 macOS,被拒时报告 UNOBSERVABLE 而非零;部分检查依赖 CC 版本(如插件校验需 CC >= 2.1.77,safe-mode 需 2.1.169+)。其余未在资料中说明的内容暂未提供。