用途:为 Claude Code 框架创建、校验并注册 hooks,处理工具执行前/后、校验、记忆与会话类钩子,适用于需要新增校验规则或自动化流程的场景。
主要能力与钩子类型:安全类(.claude/hooks/safety/,在 Bash/Write/Edit 前校验命令、拦截危险操作)、记忆类(.claude/hooks/memory/,任务完成后自动更新 learnings、提取洞见)、路由类(.claude/hooks/routing/,在 UserPromptSubmit 时强制执行 router-first 协议)、会话类(.claude/hooks/session/,会话开始/结束时的初始化与清理)。支持的 Claude Code 钩子事件包括 PreToolUse、PostToolUse、UserPromptSubmit。
使用方式(关键步骤):先做存在性检查 test -f .claude/hooks/<category>/<hook-name>.cjs && echo "EXISTS" || echo "NEW";若已存在应改用 artifact-updater 或 hook-updater,不重复创建。随后执行重复检测 checkDuplicate({ artifactType: 'hook', name, description, keywords }) 并处理 EXACT_MATCH、REGISTRY_MATCH、SIMILAR_FOUND、NO_MATCH;用户显式传 --force 可跳过该检查。确认新建后做 companion 检查,再收集需求(用途、触发时机、目标工具、拦截或仅警告、退出码)。钩子以 CommonJS 编写,需导出 validate 等函数,含 main()、findProjectRoot()、PROJECT_ROOT,并通过环境变量 {HOOK_NAME}_MODE=block|warn|off 控制执行模式。每个钩子必须配 .test.cjs 测试文件(至少 10 个用例)。创建后必须更新 .claude/hooks/README.md、在 config.yaml 或 settings.json 注册、更新 learnings.md 与 @HOOK_AGENT_MAP.md,并写 hook-registry.json;最后运行 node .claude/tools/cli/validate-integration.cjs .claude/hooks/<category>/<hook-name>.cjs 确认退出码为 0。
适用场景:需要为新校验规则、日志/遥测、记忆提取、路由约束或会话初始化添加可维护、可发现钩子的 Claude Code 项目。
限制:资料未提供该技能的安装方式、平台与收费信息;文档与注册步骤为强制项,缺失即视为创建不完整。