用途：读取 SendGrid Email Logs 与单封邮件的活动记录，不发送邮件，也不获取账户级聚合统计。
主要能力：scripts/get_email_log.sh 调用 GET /v3/logs/{sg_message_id} 获取指定邮件详情并计算 event_summary；若只有 Mail Send 的 x-message-id 或不完整 ID，可先用收件人、发送时间等条件调用 POST /v3/logs 解析完整 sg_message_id，再自动取详情。scripts/query_email_logs.sh 调用 POST /v3/logs，按收件人、发件人、状态、时间、主题、原始 query 及模糊 message ID 搜索。输出默认原始 JSON，可加 event_summary、log_resolution、matched_messages 等，支持 --output 保存文件、--dry-run 查看请求元数据。
使用方式：需完整 sg_message_id 或搜索条件，以及 SendGrid API key（--api-key、SENDGRID_API_KEY 或本地保存的 key），依赖 curl、bash、python3。示例：bash <skill-path>/scripts/get_email_log.sh --sg-message-id "abc123.recvd-xxxxxxxx"；bash <skill-path>/scripts/query_email_logs.sh --query "to_email = 'customer@example.com' AND status IN ('delivered', 'processed')" --limit 10。支持 --region global|eu、--on-behalf-of、--subuser、--summary-only 等选项。
限制：只读查询；不要为 Email Logs 使用 custom_args.business_id；动态模板发送时省略 --subject；无匹配时可到 https://app.sendgrid.com/email_logs 手动查看；缺少 API key 时参考 https://frevana.gitbook.io/frevana-docs/email-integrations/sendgrid-integration；API key 不应回显，若在聊天中泄露建议轮换。