Hooks接入指南

[
  {
    "matcher": "^Bash$",
    "hooks": [
      {
        "type": "http",
        "url": "https://hooks.example.com/pre-tool-use",
        "timeout": 30,
        "headers": {
          "Authorization": "Bearer ..."
        }
      }
    ]
  }
]

Third-Party-User-Id: external-user-001
Turn-Id: turn-001
App-Version: 1.3.2

{
  "event": "PreToolUse",
  "hook_event_name": "PreToolUse",
  "session_id": "session-xxxx",
  "transcript_path": "/path/to/transcript",
  "cwd": "/workspace"
}

{
  "decision": "block",
  "reason": "企业策略要求阻断本次处理。"
}

{
  "hook_event_name": "SessionStart",
  "source": "startup"
}

{
  "hookSpecificOutput": {
    "hookEventName": "SessionStart",
    "additionalContext": "请在交付报告时注明数据来源和统计周期。"
  }
}

{
  "hook_event_name": "PreUserPromptSubmit",
  "session_id": "session-example-001",
  "turn_id": "turn-example-001",
  "isFirstTurn": true,
  "prompt": "请分析客户张三的反馈。"
}

{
  "decision": "allow",
  "isFirstTurn": true
}

{
  "decision": "allow",
  "isFirstTurn": true,
  "updated_prompt": "请分析客户[姓名已脱敏]的反馈。"
}

{
  "decision": "block",
  "isFirstTurn": true,
  "reason": "输入包含敏感信息，请修改后重试。"
}

{
  "hook_event_name": "UserPromptSubmit",
  "prompt": "请汇总本季度客户反馈。"
}

{
  "decision": "block",
  "reason": "请移除输入中的敏感凭据后重试。"
}

{
  "hookSpecificOutput": {
    "hookEventName": "UserPromptSubmit",
    "additionalContext": "按产品线分类，使用本年度统一的反馈口径。"
  }
}

{
  "hook_event_name": "PreToolUse",
  "tool_use_id": "tool-demo-001",
  "tool_name": "Bash",
  "tool_input": {...}
}

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "ask",
    "permissionDecisionReason": "请确认是否执行项目状态检查。",
    "updatedInput": {
      "command": "git status --short"
    },
    "additionalContext": "命令已调整为只读状态检查。"
  }
}

{
  "hook_event_name": "PostToolUse",
  "tool_use_id": "tool-demo-001",
  "tool_name": "Bash",
  "tool_input": {...},
  "tool_response": {
    }
}

{
  "decision": "block",
  "reason": "工具输出包含不允许继续传递的内容。"
}

{
  "hookSpecificOutput": {
    "hookEventName": "PostToolUse",
    "updatedToolOutput": "xxxxxxx",
    "additionalContext": "请根据当前分支状态继续处理任务。"
  }
}

{
  "hook_event_name": "Stop",
  "stop_hook_active": false,
  "last_assistant_message": "季度报告已生成。"
}

{
  "decision": "block",
  "reason": "请补充报告的数据来源和统计周期，再给出最终答复。"
}

{
  "hook_event_name": "Notification",
  "notification_type": "permission_prompt",
  "message": "Tool requires confirmation",
  "details": {}
}

{
  "hook_event_name": "PreCompact",
  "trigger": "manual",
  "custom_instructions": "保留尚未完成的任务和关键约束。"
}

{}

{
  "decision": "deny",
  "reason": "当前任务仍需保留完整上下文，暂不允许压缩。"
}

{
  "hook_event_name": "PostCompact",
  "trigger": "auto",
  "compact_summary": "用户正在分析季度反馈，已完成分类，下一步生成报告。"
}

{}

{
  "hook_event_name": "ConnectorAdded",
  "source": "manual_config",
  "content_digest": "<SHA-256 十六进制摘要>",
  "connector": {
    "name": "enterprise-knowledge",
    "kind": "mcp",
    "config": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    },
    "redacted_fields": []
  }
}

{
  "decision": "allow"
}

{
  "decision": "block",
  "reason": "该连接器的服务地址不在企业允许范围内。"
}

{
  "hook_event_name": "ExpertSuiteAdded",
  "source": "local_import",
  "content_digest": "<SHA-256 十六进制摘要>",
  "expert_suite": {
    "name": "feedback-suite",
    "version": "1.0.0",
    "manifest": {
      "name": "feedback-suite",
      "version": "1.0.0",
      "description": "Customer feedback review."
    },
    "files": [
      {
        "path": "plugin.json",
        "encoding": "base64",
        "content": "ewogICJuYW1lIjogImZlZWRiYWNrLXN1aXRlIiwKICAidmVyc2lvbiI6ICIxLjAuMCIsCiAgImRlc2NyaXB0aW9uIjogIkN1c3RvbWVyIGZlZWRiYWNrIHJldmlldy4iCn0="
      },
      {
        "path": "skills/feedback-summary/SKILL.md",
        "encoding": "base64",
        "content": "LS0tCm5hbWU6IGZlZWRiYWNrLXN1bW1hcnkKZGVzY3JpcHRpb246IFN1bW1hcml6ZSBjdXN0b21lciBmZWVkYmFjay4KLS0tCiMgRmVlZGJhY2sgc3VtbWFyeQpHcm91cCBmZWVkYmFjayBieSBwcm9kdWN0Lgo="
      }
    ]
  }
}

{
  "decision": "allow"
}

{
  "decision": "block",
  "reason": "专家套件包含未经允许的自动执行脚本。"
}

{
  "hook_event_name": "SkillAdded",
  "source": "local_import",
  "content_digest": "<SHA-256 十六进制摘要>",
  "skill": {
    "name": "feedback-summary",
    "files": [
      {
        "path": "SKILL.md",
        "encoding": "base64",
        "content": "LS0tCm5hbWU6IGZlZWRiYWNrLXN1bW1hcnkKZGVzY3JpcHRpb246IFN1bW1hcml6ZSBjdXN0b21lciBmZWVkYmFjay4KLS0tCiMgRmVlZGJhY2sgc3VtbWFyeQpHcm91cCBmZWVkYmFjayBieSBwcm9kdWN0Lgo="
      }
    ]
  }
}

{
  "decision": "allow"
}

{
  "decision": "block",
  "reason": "技能包含向未授权外部地址发送企业数据的指令。"
}