SuperAPI AI 工具集

hook-integration

智能体与模型

查看项目

更新于 10-16 00:29

技能介绍

用途:该资料是一份指南,说明技能(skills)如何与 Claude Code 的 12 个 hook 事件配合,从而与 Clausitron 等 harness 深度集成。适用于创建 hook 感知技能,或需要按 hook 事件扩展技能行为的场景。

主要能力:列出 12 个 hook 事件及其触发时机与集成机会,包括 PreToolUse(工具执行前,用于校验、策略执行)、PostToolUse(执行后,用于日志、结果增强)、PostToolUseFailure(工具失败时,用于错误分析与恢复建议)、UserPromptSubmit(用户提交提示时,用于上下文注入与提示增强)、SessionStart(会话开始,用于环境准备与上下文加载)、SessionEnd(会话结束,用于生成总结与清理)、SubagentStart(子代理启动,用于预算分配与追踪)、SubagentStop(子代理完成,用于结果聚合与成本追踪)、Stop(代理停止,用于状态持久化与交接说明)、PreCompact(上下文压缩前,用于归档重要上下文)、PermissionRequest(权限对话框触发,用于基于策略的自动决策)、Notification(代理状态消息,用于外部通知如 Slack)。

使用方式:资料给出四类 hook 感知技能模式。校验技能(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 等注入上下文。总结技能(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 用量与成本,超阈值可告警并在下次 PreToolUse 返回 deny。

响应与输入 schema:PreToolUse 可返回 hookSpecificOutput 中的 permissionDecision(allow/deny/ask)、permissionDecisionReason、updatedInput;UserPromptSubmit、SessionStart、PostToolUse 可返回 additionalContext;任意 hook 可返回 systemMessage,或用 continue: false 与 stopReason 停止执行。输入 schema 按事件不同,如 PreToolUse 含 hook_event_name、session_id、tool_name、tool_input、cwd、transcript_path;SessionStart 含 source(startup/resume/clear/compact);SessionEnd 含 reason;SubagentStart 含 agent_id、agent_type;SubagentStop 含 stop_hook_active。

限制:资料未提供具体安装命令、收费或价格信息,也未说明各 harness 的完整配置步骤;默认应返回空 {} 以允许操作,并需处理缺失或格式错误的输入。