Impeccable安装后命令无法使用排查指南
面向在Cursor或Codex中配置Impeccable技能的用户，解决安装后命令无法调用、菜单不显示或钩子无响应的问题。本文梳理从终端环境检查到工具重载的完整路径：确认Node.js与PATH配置，区分npx终端命令与聊天助手指令（如/impeccable audit），通过/impeccable check和update管理版本，利用/impeccable doctor修复配置漂移，并单独核对/hooks状态以排除权限干扰，避免盲目重装导致配置覆盖。
先确认命令入口和当前项目
当技能未在预期位置出现时，首先需要核对安装器选中的工具和项目范围。完成安装后，务必重载开发工具，然后在助手中输入 /impeccable 进行测试。如果在 Codex 环境中，可以使用 $impeccable 调用，或者通过 /skills 查找已安装的技能。
需要注意的是，如果未创建快捷方式，应使用完整命令 /impeccable audit，而不是直接输入 /audit。
此外，npx impeccable install 和 detect 属于终端命令，而非聊天助手指令。如果终端提示找不到 npx，请优先检查 Node.js 是否安装以及系统 PATH 环境变量配置是否正确。在使用 detect 命令时，返回码含义如下：返回 2 表示扫描发现了主要问题，返回 1 则表示至少有一个目标无法被扫描。
主技能可调用后检查项目状态
当主技能已经可以正常调用，但需要升级或维护时，请在项目终端运行以下命令：
- 检查更新：
npx impeccable check - 执行更新：
npx impeccable update（针对由安装器管理的版本）
完成更新后，记得再次重载工具以确保更改生效。
如果技能能够调用，但出现旧上下文、配置异常或设计记录错误等问题，可以在助手中运行 /impeccable doctor。该命令专门用于修复项目文件和钩子状态的漂移问题，但它不能替代技能版本的升级。根据报告修复相关问题后，建议重新运行核对命令以验证结果。
自动检查无声时单独核对钩子
如果自动检查没有产生预期输出，可以通过输入 /impeccable hooks status 查看钩子的具体状态。
不同环境的配置位置有所区别：
- Codex 项目：钩子需要在
/hooks目录中进行批准。 - Cursor：需要在工具设置的 Hooks 选项中进行检查。
如果配置文件格式无效，请根据报告提示修正对应的文件。修复完成后，建议通过一个可控的界面修改来验证检查反馈是否正常。
若仅仅是设计命令未出现在菜单中，请回到技能发现列表进行核对。请注意，不要将钩子权限问题与技能发现问题混淆，它们是两个独立的排查方向。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，