SuperAPI AI 工具集

hook-event-architecture

设计与创作

查看项目

更新于 10-16 00:23

技能介绍

用途:为 AI Developer Workflows(ADW)设计基于 hook 的事件系统,用于捕获与广播智能体活动,支撑实时事件广播、可观测性基础设施、泳道可视化、将智能体活动写入数据库以及生成 AI 事件摘要。

主要能力:定义事件模式(ADWEvent 含 type、adw_id、step、timestamp、payload、summary);配置 Claude Code hook 触发器(PreToolUse、PostToolUse);设计事件流水线(hook 脚本负责写库、摘要、WebSocket 广播);用 Haiku 生成 15 词以内的 AI 摘要;通过 EventBroadcaster 先写库再广播。涉及的事件类型包括 PreToolUse、PostToolUse、TextBlock、ToolUseBlock、ThinkingBlock、StepStart、StepEnd,含图标、来源与负载字段。

使用方式:先调用 hook-management 技能核对当前事件类型与 hook 配置模式,确认官方事件 schema;再按步骤定义事件模式、配置 hooks.json、设计流水线、实现摘要与广播。hook 脚本示例读取 stdin JSON 并调用 broadcast 与 summarize。输出格式包含事件类型表、hook 配置、事件流水线 ASCII 图、摘要策略、广播模式、数据库 schema 与实现清单。

适用场景:实时事件广播、可观测性、泳道图、活动落库、摘要生成。

限制:事件类型为 Claude Code 内部类型,可能随版本变化,须以官方文档为准;完整 hook 事件架构需 Claude Agent SDK 与自定义工具,本技能主要提供设计模式与规范;文档未提供具体数据库 schema、WebSocket 实现细节及价格信息。需避免同步广播、缺少关联 ID、原始负载日志、缺少摘要与无错误处理等反模式。