SuperAPI AI 工具集

hooks-manager

智能体与模型

查看项目

更新于 10-16 03:52

技能介绍

hooks-manager 是一个面向 Claude Code、Codex 和 Cursor 的钩子(hooks)管理技能,用于创建、编辑、配置和调试这些平台的钩子。其核心思路是把钩子当作事件驱动的命令或提示来处理,并明确要求把不同平台的语法视为彼此独立,避免混用。

用途 该技能适用于需要为 Claude Code、Codex、Cursor 配置生命周期事件、命令校验、共享钩子路由、通知等场景。它帮助使用者在多个智能体平台之间组织钩子配置,并在平台不支持某些能力时给出报告。

主要能力

  • 创建、编辑、配置和调试 Claude Code、Codex、Cursor 的钩子。
  • 区分命令钩子(确定性执行)与提示钩子(依赖推理,若平台支持)。
  • 按平台加载对应参考文件,处理平台特有的语法与配置。
  • 支持跨智能体复用:保留一个可移植脚本,并为每个平台维护一个小型适配器。
  • 报告平台不支持的功能。
  • 提供按需加载的参考文档,包括 hook-types.md、command-vs-prompt.md、matchers.md、input-output-schemas.md、examples.md、troubleshooting.md。

使用方式

  1. 识别目标平台,并加载 router.md。
  2. 加载平台文件:claude-code.md、codex.md 或 cursor.md。
  3. 选择作用域、文件路径、生命周期事件,以及命令钩子(确定性)或提示钩子(推理型,若支持)。
  4. 校验原生配置,并运行该平台的冒烟检查。
  5. 跨智能体时,采用一个可移植脚本加每平台小型适配器的结构,并报告不支持的功能。
  6. 按需加载上述参考文件。

适用场景

  • 为 Claude Code、Codex、Cursor 配置生命周期事件钩子。
  • 需要命令校验、共享钩子路由或通知的场景。
  • 在多个智能体平台之间统一管理钩子,同时保留平台差异。

限制与注意事项

  • 不同平台的钩子语法不同,必须分别处理,不能假定通用。
  • 提示钩子仅在平台支持时可用。
  • 在 Stop/SubagentStop 事件中需检查 stop_hook_active。
  • 应使用可信的绝对路径、超时和 jq 校验。
  • 阻断规则应保持选择性,避免过度拦截。
  • 关于收费、价格、具体平台支持范围等事实,资料中暂未提供。