SuperAPI AI 工具集

hooks-patterns

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:为 Claude Code 构建钩子(hooks)提供可运行示例与配方,覆盖插件钩子、技能/智能体/斜杠命令的 frontmatter 钩子、基于提示词的 LLM 钩子,以及 Python、Node.js 代码示例。

主要能力:插件钩子可在 hooks/hooks.json 或 plugin.json 中定义,启用后与用户、项目钩子合并并并行运行;支持 ${CLAUDE_PLUGIN_ROOT}、${CLAUDE_PROJECT_DIR} 等环境变量。frontmatter 钩子作用于组件生命周期,支持全部钩子事件,子智能体常用 PreToolUse、PostToolUse、Stop(在智能体上下文中自动转为 SubagentStop);once: true 仅对技能和斜杠命令有效,不适用于智能体。基于提示词的钩子由快速模型(Haiku)评估,返回 JSON 决策 {ok, reason},type 可为 prompt 或 agent,支持 model、timeout、continueOnBlock 字段。

使用方式:命令钩子运行 bash 脚本,通过退出码或 JSON 输出控制;提示词钩子仅需配置提示词,用 $ARGUMENTS 占位符传入钩子输入 JSON。示例涵盖 Bash 命令校验、UserPromptSubmit 上下文注入与校验、PreToolUse 自动批准、SessionStart 上下文注入、代码格式化、文件保护、通知与任务验证等配置片段。

适用场景:确定性规则用命令钩子,上下文感知决策用提示词钩子;Stop 用于任务完成检测,SubagentStop 验证子智能体,PreToolUse 做复杂权限判断,PostToolUse 校验输出质量。

限制:提示词钩子需 API 调用,比本地脚本慢;once 不支持智能体;具体收费、价格与平台支持情况暂未提供。