SuperAPI AI 工具集

tool-hooks-doctor

智能体与模型

查看项目

更新于 10-15 21:38

技能介绍

用途:快速验证 Claude Code 中用于技能演化(skill-evolution)的 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 .claude/settings.json 与 test -f ~/.claude/settings.json,并用 grep -n 检查四个脚本命令;全部不匹配说明未启用,部分匹配说明配置不完整需修复。3) 可选运行时冒烟测试:用户确认后运行无害 bash 命令,再 ls -la runs/evolution 2>/dev/null || true。

修复(写操作,需确认):未启用时建议安装项目级 hooks(比全局更安全)。执行前须明确告知将写入哪个文件(项目级 <repo_root>/.claude/settings.json,推荐;或全局 ~/.claude/settings.json),等待用户明确确认。安装脚本为 python3 内联脚本,向 .claude/settings.json 写入预定义的 PreToolUse、PostToolUse、Stop 事件 hook 命令。全局安装同理,写入 ~/.claude/settings.json。

限制:仅适用于支持 Claude 风格 hooks 的环境;修复需用户确认;未提供其他功能、收费或平台信息。