用途
Doctor 用于从 harness 内部检查 GodMode 的安装状态。GodMode 的各技能能否触发,依赖会话启动时注入的引导文件;一旦引导缺失,所有其他技能都不会生效,因此应先执行这项检查。
适用时机
- 用户询问“GodMode 是否在工作”“为什么 GodMode 没有激活”,或执行 doctor 命令。
- 在新的 harness 或机器上安装或更新 GodMode 之后。
- 本应触发的技能(例如写代码前先设计、宣告完成前先验证)没有触发。
除此之外的情况一律跳过,因为该技能只检查安装状态。
使用方式
- 定位安装根目录:它包含存放本技能文件的
skills/文件夹。不要凭记忆猜测路径,应根据本技能的加载位置推导。 - 用 shell 运行:
<install-root>/hooks/run-hook.cmd doctor。在 Windows 上如果没有 Git Bash,包装脚本会静默退出且没有输出;此时应说明这一情况,并建议用户安装 Git for Windows。 - 逐行阅读输出:
ok行表示通过,FAIL行表示问题所在,info行描述环境(harness、平台、版本)。 - 报告检测到的 harness 与版本、每一项失败及其脚本打印的修复办法,以及是否需要开启新会话(引导只在会话启动时注入)。
- 如果脚本本身无法运行,应报告具体错误和推导出的安装根目录;没有脚本输出,不得声称安装健康。
脚本检查项
skills/using-godmode/SKILL.md可读:会话启动钩子会注入该文件,缺少它则一切不会触发。- 技能数量超过 20:用于识别不完整安装或错误的根目录。
- 钩子脚本可执行且以 LF 结尾:GodMode 1.0 曾缺少可执行位,导致钩子从未运行(issues #1、#2、#4)。
hooks.json引用插件根目录:单引号会阻止变量展开。- session-start 输出 Claude Code 的 JSON 结构:harness 读取的正是钩子的输出。
限制与约束
- 该技能只做诊断,不修改用户 harness 设置;发现问题应报告并交由用户决定。
- 不得从提示文本猜测 harness,应读取输出中的 info harness 行。
- 必须从推导出的安装根目录运行脚本,并逐字引用失败信息及脚本打印的修复办法。
- 需要明确告知用户是否需开启新会话。
- 插件更新可能改变安装文件夹,每次更新后都应重新检查。