菜单
Build, maintain, and operate the contract-driven hook workspace with serve/relay/smash roles, Kafka core transport, and plug-and-play adapters. Use when editing runtime behavior, contract validation, adapter/plugin execution, or deployment documentation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Maintain the kafka-openclaw-hook compatibility binary and its integration with hook-runtime smash execution. Use when changing startup wiring, runtime env expectations, deployment compatibility, or smash adapter/plugin behavior.
Maintain shared relay-core contracts, validation, envelope models, and security primitives used by serve, relay, smash, and hook-runtime. Use when changing contract schema, active-profile validation, model compatibility, or signature/sanitization/timestamp logic.
Add a new webhook source to hook serve. Covers implementing the SourceHandler trait, registering the handler, adding HMAC secret config, creating the Kafka topic, and writing tests. Use when integrating a new webhook provider (e.g. Stripe, PagerDuty, Bitbucket).
Provision and operate Apache Kafka in KRaft mode inside a Firecracker microVM without Docker, including host networking, guest bootstrap, systemd service, and security checks. Use when setting up a lightweight isolated Kafka broker for internal pipelines such as hook serve/relay/smash Kafka core transport.
Trace a webhook through the full hook pipeline (serve → relay → smash), inspect Kafka topic contents, check consumer group lag, and replay messages from the DLQ. Use when a webhook is lost, delayed, or failing delivery, or when diagnosing any serve/relay/smash runtime issue.
End-to-end release process for hook: version bumps, local validation gate, binary release via tag push, and crates.io publish in dependency order. Use when cutting a new release or diagnosing a failed publish.
| name | hook-serve |
| description | Build, maintain, and operate the contract-driven hook workspace with serve/relay/smash roles, Kafka core transport, and plug-and-play adapters. Use when editing runtime behavior, contract validation, adapter/plugin execution, or deployment documentation. |
src/: serve runtime (hook-serve)tools/hook/: operator CLI for role execution and ops workflowsapps/default-openclaw/: canonical compatibility contractapps/kafka-openclaw-hook/: compatibility wrapper binary for smash runtimecrates/relay-core/: contracts, validator, shared envelope/security primitivescrates/hook-runtime/: smash runtime and adapter execution engineconfig/kafka-core.toml: Kafka core config referencesystemd/, firecracker/, scripts/: deployment and operationscargo fmt --allcargo clippy --workspace --all-targets -- -D warningscargo test --workspaceREADME.mddocs/CHANGELOG.mddocs/spec.mdtools/hook/README.mdcrates/relay-core/README.mdcrates/hook-runtime/README.md