用途：create-hook 用于在插件中设计并生成事件驱动的 hook 配置，而非创建交互式斜杠命令（应使用 create-command），也不用于 GitHub Actions 智能体工作流。
主要能力：按分阶段工作流引导完成 hook 设计——选择事件、选择处理器类型（command / prompt / agent）、设计 matcher 与逻辑，最后写出 hook 条目。输出为 hooks.json 条目或 SKILL.md frontmatter 块，包含事件、matcher、处理器类型、command/prompt 内容与输出 schema。
使用方式：可传入可选参数 $ARGUMENTS，指定 hook 事件类型（如 PreToolUse、Stop、PermissionRequest）或用例描述（如“阻止危险的 bash 命令”）；省略则进入发现流程。若参数已给出事件或用例，会用于初始化第一阶段提问。生成后用 validate_hook_schema.py 校验，用 test_hook.py 测试，并报告放置位置（全局 hooks.json 还是技能级 frontmatter）与后续步骤。
生成 Python hook 脚本时的规范：跨平台命令使用 python3 ... || python ...，例如 { "type": "command", "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/script.py || python ${CLAUDE_PLUGIN_ROOT}/hooks/script.py" }；并加入项目类型守卫，在 main() 开头提前退出，使脚本在缺少所需上下文的项目中静默跳过，例如检查 project_root / "context" 是否存在，可按需改为 .agent/、context/os-state.json 等。
边界情况：参数为空时从第一阶段的事件选择问题开始；请求的事件不在 13 个受支持事件内时说明有效选项；用例暗示技能级 hook 时生成 frontmatter 语法而非全局 hooks.json 条目；若要自动批准子代理权限，使用 PermissionRequest 加 prompt 处理器。
限制：资料未提供具体收费、价格、平台支持范围与效果数据。