用途:快速验证 Claude Code 中用于技能演化的 hooks 是否已安装并启用。这是一个原子诊断工具,供其他工作流调用,以便在演化循环未激活时尽早告警。
适用范围:Claude Code 的 hook 安装与配置。不适用于 Cursor、OpenCode 等不支持 Claude 风格 hooks 的工具。
健康状态判定:hook 脚本存在于 ~/.claude/skills/skill-evolution/hooks/;设置文件在项目级 <repo_root>/.claude/settings.json 或全局 ~/.claude/settings.json 中启用 hooks;会话在 <project_root>/runs/evolution/<run_id>/... 下产生产物。
只读检查:报告 OK / PARTIAL / MISSING。1) 检查脚本是否安装:ls -la ~/.claude/skills/skill-evolution/hooks/ 2>/dev/null || true,必需文件为 pre-tool.sh、post-bash.sh、post-tool.sh、session-end.sh,缺失则需先安装或更新 skill-evolution 技能。2) 检查设置是否启用:用 test -f 检查两处 settings.json 是否存在,并用 grep -n 搜索四个 hook 脚本路径;全部未匹配表示未启用,部分匹配表示配置不完整需修复。3) 可选运行时冒烟测试:经用户确认后运行无害 bash 命令,再执行 ls -la runs/evolution 2>/dev/null || true。
修复(写入,需确认):若未启用,建议安装项目级 hooks(比全局更安全)。应用前须明确告知将写入哪个文件:项目级 <repo_root>/.claude/settings.json(推荐)或全局 ~/.claude/settings.json,然后等待用户明确确认。安装脚本为 python3 内联脚本,会读取或创建 settings.json,合并 PreToolUse、PostToolUse、Stop 三类 hook 配置,写入前对已有文件生成 .bak 备份。全局安装方式相同,只是写入 ~/.claude/settings.json。
限制:仅适用于 Claude Code;修复步骤会修改配置文件,必须获得用户确认;资料未提供其他平台支持、收费或效果信息。