用途:当用户想为 Codex 添加 hooks 并说明期望行为时使用本技能,帮助创建或更新 hook。
主要能力:确定作用域(全局使用个人/主目录作用域,项目使用仓库作用域,不明确时询问“Should this be global or project-scoped?”);确定 hook 类型(SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop,不明确时询问,多个 hook 除非明确要求共享行为否则分开处理);确定行为,优先采用满足需求的最小确定性脚本。
使用方式:全局写入 ~/.codex/hooks.json 与 ~/.codex/hooks/;项目写入 <repo>/.codex/hooks.json 与 <repo>/.codex/hooks/,脚本路径尽量显式且相对。若目标 Codex 构建仍限制 hooks,需在相关 config.toml 中设置 [features] codex_hooks = true 启用功能标志。输出保持清晰:用 statusMessage 给出简短可见信号;日志类 hook 写入仓库本地或主目录本地日志文件;阻断类 hook 仅在确实应停止工具时返回非零退出码。最后运行应触发 hook 的命令,确认日志、输出或阻断行为与所请求的作用域和事件一致。
适用场景与默认建议:PreToolUse 用于预防,PostToolUse 用于日志、格式化或测试后续,UserPromptSubmit 用于提示词塑形与注入上下文,SessionStart 用于启动上下文,Stop 用于回合结束检查。
限制:资料未提供更多平台、收费或效果信息。