用途:该资料是技能与 Claude Code 的 12 个 hook 事件集成的指南,用于创建 hook 感知技能,以便与 Clausitron 等 harness 深度集成。
主要能力:列出 12 个 hook 事件及其触发时机与集成机会,包括 PreToolUse(工具执行前,用于校验、策略执行)、PostToolUse(执行后,用于日志、结果增强)、PostToolUseFailure(工具失败时,用于错误分析、恢复建议)、UserPromptSubmit(用户提交提示时,用于上下文注入、提示增强)、SessionStart(会话开始,用于环境准备、上下文加载)、SessionEnd(会话结束,用于生成总结、清理)、SubagentStart(子代理启动,用于预算分配、追踪)、SubagentStop(子代理完成,用于结果聚合、成本追踪)、Stop(代理停止,用于状态持久化、交接说明)、PreCompact(上下文压缩前,用于归档重要上下文)、PermissionRequest(权限对话框触发,用于基于策略的自动决策)、Notification(代理状态消息,用于外部通知如 Slack)。
使用方式:资料给出四类模式。校验技能(PreToolUse)对 Write/Edit 检查 file_path 是否匹配 .env、credentials、/config/production/ 等阻止模式,命中返回 permissionDecision: 'deny';对 Bash 解析危险命令如 rm -rf /、curl | bash,返回 'ask'。上下文注入技能(SessionStart/UserPromptSubmit)在会话开始读取 docs/SPRINT.md、git log --oneline -10、docs/KNOWN_ISSUES.md,在提示提交时按关键词注入 API 文档、schema、测试模式。总结技能(SessionEnd/Stop)生成含 session_id、duration_minutes、files_modified、key_accomplishments、open_questions、next_steps 的 JSON,写入 .claude/session-summaries/{session_id}.json 并更新 .claude/HANDOFF.md。成本追踪技能(SubagentStart/SubagentStop)记录 agent_id、agent_type、时间戳与预算,停止时计算 token 用量、成本与时长,超阈值可触发 deny。
响应与输入 schema:PreToolUse 可返回 hookSpecificOutput 中的 permissionDecision(allow/deny/ask)、permissionDecisionReason、updatedInput;UserPromptSubmit、SessionStart、PostToolUse 可返回 additionalContext;任意 hook 可返回 systemMessage,或 continue: false 与 stopReason 停止执行。输入包含 hook_event_name、session_id、cwd、transcript_path 等,PreToolUse 另有 tool_name、tool_input,SessionStart 有 source,SessionEnd 有 reason,SubagentStart 有 agent_id、agent_type,SubagentStop 有 stop_hook_active。
限制:资料未提供安装命令、收费或价格信息;需自行处理缺失或格式错误的输入,默认返回空 {} 以放行操作。