核心用法
Buck Mason Stylist 是一款深度整合品牌官方电商能力的个人购物 Agent，专为 Buck Mason 男装（及扩展女装线）用户提供端到端的智能导购服务。激活后，Agent 会读取用户预设的 profile.md（尺码、地址、风格偏好）、wardrobe.md（已有衣物清单）和 events.md（ upcoming 行程与着装要求），从而在无需重复询问基础信息的前提下完成以下任务：
1. 实时库存查询：搜索商品 → 按用户档案中的尺码匹配变体 → 查询官网库存 + 附近门店库存（支持 25 英里半径），返回「线上有货/缺货」及「最近门店距离」。
2. 穿搭胶囊推荐：结合季节气候（干燥/潮湿/沿海温和/高海拔）、场合正式度（1–6 级量表）、用户风格 ethos（经典 vs 潮流偏好）及 wardrobe 缺口分析，生成带理由的单品推荐。
3. AI 试穿 Lookbook（三级降级）：
4. 一键结账：支持两种路径——浏览器跳转（Shopify 购物车直链）或 Agent 代付（MPP 协议 + Stripe Link 共享支付令牌，需用户手机端推送确认）。
5. 订单追踪与退货：通过订单号（?order_code=）或邮箱魔法链接查询物流状态、发起退货并生成退货标签。
- Premium：调用 OpenAI gpt-image-2 生成用户上身效果图（需
OPENAI_API_KEY+ 已验证组织 + 参考照片）。 - Editorial：品牌官方模特图 + 平铺图排版。
- Minimum：文字清单 + 价格 + 库存 + 购买链接。
显著优点
- 品牌官方背书：由 Buck Mason 与 Pima 联合维护，直接对接官方 MCP 端点与订单系统，商品数据、库存、价格实时同步，非第三方爬虫。
- 记忆化体验：一次录入尺码与偏好，跨会话复用，显著降低购物摩擦。
- graceful 降级：Premium 图像生成失败或无 API Key 时自动降级至 Editorial/Minimum 层级，从不阻断购物流程。
- 安全支付设计：Agent 代付采用 Stripe Link SPT（一次性共享支付令牌），用户需在手机端推送确认；不存储、不询问银行卡号。
- 隐私优先的订单查询：默认使用订单号直查（无邮箱授权），仅在用户明确要求「查看全部历史订单」时才触发邮箱魔法链接流程，且需用户确认邮件读取方式（粘贴链接 vs Agent 读取）。
潜在缺点与局限性
- Premium 图像生成门槛高：需 OpenAI 已验证组织 + gpt-image-2 权限，普通开发者或用户可能无法体验 AI 试穿。
- 地域限制：门店库存查询依赖美国邮编（
near_zip），国际用户仅能查看线上库存。 - 风格推理黑盒：
style-reasoning.md中的气候/正式度矩阵虽文档化，但实际权重与阈值未完全暴露，极端天气或模糊场合的推荐可能需要人工复核。 - MPP 代付依赖 Stripe Link：用户需预先注册 Stripe Link 并授权，覆盖人群有限；否则只能回退至浏览器结账。
- 邮箱授权流程繁琐：若用户坚持查看完整订单历史，需等待魔法链接邮件，且 Agent 读取邮件需额外 MCP 授权，体验不及订单号直查流畅。
适合人群
- Buck Mason 忠实顾客：已熟悉品牌版型（如 Pima Tee、Daily Shirt），希望减少重复输入尺码的 friction。
- 注重效率的商务差旅人士：需要为特定行程（婚礼、商务会议、度假）快速生成符合气候与 dress code 的胶囊衣橱。
- 视觉决策者：愿意上传参考照片以体验 AI 试穿，提前预览搭配效果。
- 隐私敏感用户：偏好订单号直查而非邮箱授权，避免过度分享账户权限。
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| **支付误操作** | Agent 代付时总价与用户预期不符 | 强制「同轮确认」：在发起 MPP 第二阶段前，以纯英文重述总价；Stripe SPT 需用户手机推送确认，构成最终授权。 |
| **AI 图像误导** | Premium 试穿图为 AI 生成，非真实上身效果 | 所有 Lookbook 封面/页脚强制披露「AI-generated preview, not actual garment photo」。 |
| **隐私泄露** | `profile.md` 含家庭住址、参考照片；`wardrobe.md` 反映消费习惯 | 建议存储于用户本地 Agent 工作区，不上传至第三方；Skill 明确禁止 Agent 读取 `SECURITY.md` 等敏感仓库文件。 |
| **库存幻觉** | MCP 与 Shopify 推送延迟可能导致短暂库存不一致 | 技能文档建议「交叉校验」：对关键订单先浏览 `buckmason.com` 确认商品仍在线，再调用 MCP 结账。 |
| **依赖服务中断** | Pima MCP 或 OpenAI 图像端点故障 | 已设计多级降级（Shopify 直连、文字清单），并提示用户服务降级原因。 |