SuperAPI AI 工具集

doctor

部署与运维

查看项目

更新于 10-29 19:52

技能介绍

用途

Doctor 用于从 harness 内部检查 GodMode 的安装状态。GodMode 的各技能能否触发,依赖会话启动时注入的引导文件;一旦引导缺失,所有其他技能都不会生效,因此应先执行这项检查。

适用时机

  • 用户询问“GodMode 是否在工作”“为什么 GodMode 没有激活”,或执行 doctor 命令。
  • 在新的 harness 或机器上安装或更新 GodMode 之后。
  • 本应触发的技能(例如写代码前先设计、宣告完成前先验证)没有触发。

除此之外的情况一律跳过,因为该技能只检查安装状态。

使用方式

  1. 定位安装根目录:它包含存放本技能文件的 skills/ 文件夹。不要凭记忆猜测路径,应根据本技能的加载位置推导。
  2. 用 shell 运行:<install-root>/hooks/run-hook.cmd doctor。在 Windows 上如果没有 Git Bash,包装脚本会静默退出且没有输出;此时应说明这一情况,并建议用户安装 Git for Windows。
  3. 逐行阅读输出:ok 行表示通过,FAIL 行表示问题所在,info 行描述环境(harness、平台、版本)。
  4. 报告检测到的 harness 与版本、每一项失败及其脚本打印的修复办法,以及是否需要开启新会话(引导只在会话启动时注入)。
  5. 如果脚本本身无法运行,应报告具体错误和推导出的安装根目录;没有脚本输出,不得声称安装健康。

脚本检查项

  • 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 行。
  • 必须从推导出的安装根目录运行脚本,并逐字引用失败信息及脚本打印的修复办法。
  • 需要明确告知用户是否需开启新会话。
  • 插件更新可能改变安装文件夹,每次更新后都应重新检查。