用途:帮助主动选择编写自有运行时可挂钩(hooks)的操作者,以可移植行为、清晰匹配器、确定性测试和终止开关的方式完成编写。AgentOps 3.0 默认不附带任何 hooks,工作流由技能与 ao CLI 引导,CI 是权威关卡;本技能不属于默认产品面,仅用于操作者自行向自己的 harness 添加 hooks。
主要能力与流程:定位或创建自己的 hook 面(运行时清单 hooks/hooks.json、hook 脚本 *.sh、校验用 schemas/hooks-manifest.v1.schema.json);选择生命周期事件与匹配器(参考 references/event-taxonomy.md、references/matcher-patterns.md);编辑前先定义契约(输入、输出模式与退出码、fail-open 与 fail-closed 决策、终止开关、超时与可移植性约束);窄范围实现(shell 中使用 set -euo pipefail,从清单/插件根解析路径而非调用方 CWD,避免 eval、反引号、未加引号变量和隐式通配,输出保持 Claude 与 Codex 都接受的子集,避免 Codex 会静默丢弃的 hookSpecificOutput.updatedInput);接线清单(使用覆盖目标工具或生命周期的最窄匹配器,添加显式超时,除非行为依赖顺序否则保留现有顺序);用自有 fixture 直接测试并运行 ShellCheck;记录证据(改动文件、fixture 命令、关卡输出、fail-open/fail-closed 选择)。
限制与护栏:hook 必须是关卡或有界适配器,不能是噪声注入器;不得在每次匹配事件时无条件向提示窗口推送 additionalContext/建议性文本。不要为掩盖缺失用例而放宽匹配器,应新增第二个 hook 条目;不要依赖 Codex 忽略的输出字段;不要在受跟踪的 hook fixture 中存放会话密钥、转录或本地运行时状态;hook 编写文档与活动护栏行为分开,编辑范围强制使用 /scope。
适用场景:仅在有意编写或审查自有运行时可挂钩时使用。参考文件包括 references/event-taxonomy.md、references/matcher-patterns.md、references/test-harness.md 及可执行规范 references/hooks-authoring.feature。