SuperAPI AI 工具集

claude-code-plugin-hacker

智能体与模型

查看项目

更新于 10-16 06:22

技能介绍

用途:这是一个专门调试和修复 Claude Code 插件系统问题的技能,适用于启动时出现 SessionStart:startup hook 错误、插件启用或禁用后行为不符合预期、排查插件与 hook、skill 的交互、跨项目修复损坏的插件 hook,以及审计哪些插件向会话注入了内容。

主要能力:技能强调若干关键事实。enabledPlugins: false 并非终止开关,设为 false 时 hooks 仍会执行、skills 仍可通过 Skill 工具访问,只有 CLAUDE.md 和 agents 可能不加载或未注册;要真正停止 hook 需编辑缓存中的 hooks.json、删除缓存目录或修复脚本。插件缓存按版本存放于 ~/.claude/plugins/cache/<marketplace>/<plugin>/<hash>/,hash 为 ~/.claude 仓库的 git commit hash,新提交会产生新缓存目录,修复一个缓存版本不会修复其他版本,需用 find ... -exec 批量处理。hook 运行在受限环境:PATH 受限、环境变量精简、执行超时短,stdin 接收 JSON 上下文,stdout 必须输出合法 JSON,非零退出码会向用户显示 hook error。

使用方式:技能给出四阶段流程。审计阶段用 find 枚举所有 hooks.json、定位 SessionStart hook、检查 settings.json 中的用户 hook 与 enabledPlugins、统计每个插件的缓存版本数。诊断阶段用 echo '{"source":"startup","session_id":"diag-test"}' 配合 CLAUDE_PLUGIN_ROOT 单独测试 hook 脚本并查看退出码,并对照已知故障模式:权限拒绝(EACCES、退出码 126/127,脚本缺 +x)、未设置变量(set -u 导致无输出退出 1)、Node 模块版本不匹配(NODE_MODULE_VERSION,需 npm rebuild)、数据库锁定、命令未找到(受限 PATH)、JSON 解析错误。修复阶段提供批量 chmod +x、移除 set -u、npm rebuild、清空 hooks.json 事件、删除插件缓存等方案。验证阶段重新测试所有 hook。

限制:资料未提供该技能的安装命令、收费或价格信息,也未说明其支持的平台范围;文中还包含在 Codex 与 Cursor 中运行时的原语映射说明,但具体可用性取决于对应环境是否提供相应工具。