diagnose 是 cc-suite 配套的健康检查技能,作用是在当前项目中运行完整健康检查,说明每项问题,并自动修复可自动处理的部分,相当于 /cc-suite:diagnose 命令的技能版本。
适用场景:会话开始时桥接产物可能缺失或过期;更新 cc-suite 后确认新版本已正确接入;或 /cc-suite:audit、/cc-suite:audit-fix 及 /cc-suite:claude-* 技能行为异常时。
流程分六步。一是状态检查,运行 bash "${CLAUDE_PLUGIN_ROOT}/scripts/status.sh"。二是深度检查,包括:查找 macOS ln -sf 残留的嵌套软链、检查 codex 命令是否存在、比较软链目标版本与已安装插件版本判断缓存是否过期、检测断链。三是诊断报告,根据状态输出中的缺失与警告行汇总问题清单(若项目 .claude/settings.json 无 hooks 段,则 .codex/hooks.json 缺失属预期,不计入)。四是询问是否修复,提供 yes、仅显示命令、取消三种选择。五是执行修复,按问题类型运行对应脚本:bridge_skills.sh 处理 .agents/skills、.claude/skills/cc-suite 及缓存过期;bridge_hooks.py 处理 .codex/hooks.json;mcp_codex.sh、mcp_claude.sh 与 bridge_mcp.sh 处理 MCP 配置及一致性;嵌套软链需先 rm 目标再运行 bridge_skills.sh;plugin_hooks 未设置需在 ~/.codex/config.toml 的 [features] 下写入 plugin_hooks = true。六是重跑状态脚本并汇总已修复与剩余问题。
需手动处理、不自动修复的情况包括:项目信任未通过需在目录中运行 codex 并接受提示;未找到 Codex CLI 需按官方地址安装;缺少 AGENTS.md 需在 Claude Code 会话中运行 /cc-suite:init。若自动修复后问题仍在,提示运行 /cc-suite:repair 完整非交互重跑,仍失败则运行 /cc-suite:init 交互式重新初始化。
限制:各项修复依赖 cc-suite 插件提供的脚本与 Claude 环境,部分步骤涉及 Codex 与手动确认;资料未提供具体版本兼容性、价格等信息。