#AI 集成路线图

Claude Code 不开源。 它是 Anthropic 的商业产品（CLI 工具），代码不公开。

更重要的是，Claude Code 的 Built-in Tools 是给程序员写代码用的，不是给健身房老板用的：

Claude Code 的 Read/Write/Grep 对 gym owner 毫无用处。我们需要的是健身房业务领域的 tools。

Anthropic Agent SDK（TypeScript + Python）是开源的，但定位是给开发者做内部工具（SRE 机器人、代码审查、oncall 助手）。对客户产品来说，直接用 Claude API tool-calling 更简单、更可控。

#:::

#二、我们实际拥有什么能力

Claude Code 里让人觉得"很厉害"的能力——tool-calling、多轮推理、自动选择工具——不是 Claude Code 的能力，是 Claude API 的能力。 直接调 API 就有。

Claude Code 的架构可以拆解为 6 层（参见 AI 工具体系指南 §3.2）。每一层我们都能自己实现：

核心 loop 代码只有 30 行：

async function agenticChat(userMessage: string, tenantId: string) {
  const messages = [{ role: "user", content: userMessage }];

  let response = await anthropic.messages.create({
    model: "claude-opus-4-6",
    system: GYM_SYSTEM_PROMPT,  // Skills 内容编译进来
    tools: GYM_TOOLS,           // 业务 tools
    messages,
  });

  // Agentic loop: AI 自己决定调几次 tool
  while (response.stop_reason === "tool_use") {
    const toolCall = response.content.find(b => b.type === "tool_use");
    const result = await executeTool(toolCall.name, toolCall.input, tenantId);

    messages.push({ role: "assistant", content: response.content });
    messages.push({ role: "user", content: [{
      type: "tool_result", tool_use_id: toolCall.id, content: result
    }]});

    response = await anthropic.messages.create({
      model: "claude-opus-4-6",
      system: GYM_SYSTEM_PROMPT,
      tools: GYM_TOOLS,
      messages,
    });
  }

  return response.content.filter(b => b.type === "text");
}

这个 while 循环就是 Claude Code 的核心。AI 工具体系指南 §3.7 描述的 7 步流程，在这段代码里全部体现。

#三、正确的产品架构

不需要 MCP、不需要 Agent SDK、不需要嵌入 Claude Code。我们要的是在 Vue 前端加一个 AI Chat 面板，背后是 Hono API 调 Claude API。

┌─────────────────────────────────────────────────────────────┐
│  apps/web (Vue 3)                                            │
│  ├── Dashboard（已有）                                       │
│  ├── AI Chat Panel（新）← 老板在这里跟 AI 对话               │
│  └── Campaign Wizard（新）← AI 推荐 + 人工审批               │
└──────────────────────┬──────────────────────────────────────┘
                       │ HTTP
┌──────────────────────▼──────────────────────────────────────┐
│  apps/api (Hono + Lambda)                                    │
│  ├── /api/ai/chat     ← 接收用户消息                         │
│  ├── agenticLoop()    ← while(tool_use) 循环                 │
│  ├── GYM_TOOLS:                                              │
│  │   ├── search_leads()        → DynamoDB PhoneBook          │
│  │   ├── get_call_analysis()   → DynamoDB call-analysis      │
│  │   ├── get_sms_thread()      → DynamoDB MessageStore       │
│  │   ├── query_metrics()       → Neon PostgreSQL             │
│  │   ├── create_task()         → DynamoDB Tasks              │
│  │   └── generate_campaign()   → 模板验证 + 返回预览          │
│  └── GYM_SYSTEM_PROMPT:                                      │
│      ← docs/skills/gym-domain/*.md 的内容编译进来             │
└─────────────────────────────────────────────────────────────┘
                       │
              Anthropic API (Claude Opus 4.6)

#为什么不需要 MCP

MCP 是给"多个不同 AI client 连同一个 server"的场景设计的（参见 AI 工具体系指南 §3.1）。我们的产品只有一个 AI backend（Hono API），直接在代码里写 tool 函数就行。

Tool-calling 本身就是结构化的（JSON schema）、安全的（tenant 隔离）、可扩展的。

#为什么不需要 Agent SDK

我们的 agentic loop 就是一个 while 循环 + 6 个 tool 函数。Agent SDK 解决的是更复杂的场景（多 agent 编排、文件系统操作、长时间会话）。

#Skills 怎么用

不是给客户用的产品功能，而是两用：

1. 开发时 — Claude Code 加载 Skills，理解健身房业务逻辑
2. 生产环境 — Markdown 内容编译进 GYM_SYSTEM_PROMPT

// 构建时把 Skill 内容注入 system prompt
import { readFileSync } from "fs";

const OBJECTION_SKILL = readFileSync(
  "docs/skills/gym-domain/objection-framework.md", "utf8"
);

const GYM_SYSTEM_PROMPT = `你是一个健身房销售和客户留存 AI 助手。

## 异议分类框架
${OBJECTION_SKILL}
`;

知识随代码库演进。更新 Markdown，所有 AI 分析自动使用新版本。

#四、ROI 排序：TOP 10 集成机会

知道了能力边界后，按 ROI 排优先级。

#五、详细 Workflow

##1 AI 诊断对话

ROI 最高，改变用户体验。

老板在 Dashboard 点击一个 lead/member，问 "为什么这个人流失了？"。AI 自动拉取通话记录、SMS 历史、付款记录、到访频率，综合诊断原因并推荐行动。

老板点击 "Diagnose" 按钮
→ 前端发送 { member_id, question } 到 Hono API
→ API 调用 Claude Opus 4.6 + 4 个 tools:
    ├─ get_member_history (PhoneBook)
    ├─ get_call_analysis (call-analysis 表)
    ├─ get_sms_thread (MessageStore)
    └─ get_payment_history (外部/DDB)
→ Claude 自动选择需要的 tools，多轮调用
→ 返回结构化诊断: 根因 + 贡献因子 + 推荐行动
→ 前端展示卡片式结果

为什么 ROI 最高： 直接回答老板最核心的问题——"我的钱去哪了？"。目前老板要自己翻 3 个不同的页面去拼凑答案，AI 把这变成一次点击。

技术选型： Claude API tool-calling。不是 Bedrock Agents，不是 Agent SDK。

• 所有数据已在 DynamoDB + Neon
• 每次请求约 $0.003，成本极低
• 延迟 2-5 秒，可接受

核心挑战： 定义好 4-5 个 tools 的 JSON schema，做好 tenant 隔离（每个 query 必须带 tenantId）。

##2 Dashboard 文字洞察

最快见效。

Dashboard 顶部加一段 AI 生成的文字总结：

"本周转化率下降 5%，主要原因是周三的 3 个高意向 lead 爽约。建议：给这 3 人发 SMS 重新预约。"

Daily Batch Job (06:00 UTC，已设计好)
→ 查询 Neon: 关键指标 vs 上周/上月对比
→ Claude 生成 3-5 句自然语言总结
→ 存入 DDB summary 表
→ 前端 Dashboard 加载时显示

为什么 ROI 高： 实现最简单（2-4 周），但对老板感知价值巨大。从看数字变成看"AI 在说话"。这是 Level 1 Describe，也是产品从"工具"变成"顾问"的第一步。

技术选型： 复用已有的 Daily Batch 架构（AI 分析插入点设计 Layer 2），加一个 summary generation 步骤。

##3 Campaign Engine

最大的产品差异化。 详见 Campaign Engine 设计。

关键技术决策：自研 tool-calling，不用 Bedrock Agent。

Workflow 使用 Orchestrator/Specialist 模式：

老板: "给这个月到期的会员做个召回活动"

Campaign Orchestrator (Claude Opus 4.6)
├── 调用 tool: search_expiring_members → 找到 47 人
├── 调用 tool: analyze_churn_risk → 筛出 12 个高风险
├── 调用 tool: get_interaction_history → 了解每人情况
├── 生成个性化 SMS 文案（基于通话记录中的兴趣点）
├── 调用 tool: validate_campaign → 模板合规检查
└── 返回: 活动方案 + 12 条个性化 SMS 预览

老板审核 → 点击确认 → 批量发送

竞品对标： Keepme（健身房 AI）用 Random Forest 预测流失，准确率 95%。但 Keepme 是事后预测（predict churn），我们是事中干预（influence outcome during call + proactive outreach）。这是核心差异。

##4 Staff Coaching

已设计好，直接落地。

Per-Call AI 分析出 coaching 建议，告诉 manager "这个员工在处理价格异议时错过了 3 个机会"。

已有能力：

• Deepgram 转录 ✅
• Bedrock AI 分析 ✅（AI 分析插入点设计 Layer 1）
• call-analysis 表 ✅

缺什么：结构化的 coaching 输出 schema（异议类型分类、评分、改进建议）。

Workflow：复用 Per-Call 管道，在 Prompt A 里增加 coaching 输出字段。

##5 内部 Skills

投入最小，持续回报。

不是客户产品功能，而是给团队用的领域知识库。

docs/skills/
├── gym-call-analysis/
│   ├── objection-framework.md    # 异议分类: 价格/时间/健身水平/承诺
│   ├── coaching-patterns.md      # 销售技巧模板
│   └── churn-risk-signals.md     # 流失信号定义
├── campaign-engine/
│   ├── campaign-templates.md     # 活动模板库
│   └── compliance-rules.md       # TCPA 合规规则
└── data-pipeline/
    └── troubleshooting.md        # 管道故障排查

双重用途：

1. Claude Code 加载 — 开发时自动理解业务逻辑
2. 注入 system prompt — 生产环境把 Markdown 内容嵌入 AI 的系统提示词（见§三代码示例）

ROI：投入 1-2 周整理现有知识 → 永久提升所有 AI 分析的质量。

##6 Churn 预测模型

需要 ML 基础设施。

Claude 不是统计预测器，它是推理引擎。需要混合架构：

ML 模型（RandomForest / XGBoost）
→ 每日 batch 对所有活跃会员评分
→ 输出: (member_id, churn_probability, top_3_factors)

Claude
→ 接收预测结果 + 会员历史
→ 生成自然语言解读 + 推荐行动

前提条件：2 年以上历史数据 + 模型训练。Neon PostgreSQL 可以存储特征数据，Lambda 跑 batch scoring。

##7 自动 Task 生成

AI 根据通话结果自动创建跟进任务。

Per-Call AI 分析完成
→ 判断: 需要跟进吗？什么类型？
→ 调用 tool: create_task
    ├─ lead_id
    ├─ employee_id
    ├─ task_type: "call" | "sms" | "appointment"
    ├─ description: "客户表达价格顾虑，建议 3 天内跟进提供分期方案"
    └─ due_date: 3 天后
→ Tasks 表写入
→ 员工端看到待办

关键：使用模板验证。AI 推荐的 task 必须匹配预定义模板，不允许自由发挥。

##8 MCP Server

面向生态，不面向终端用户。

MCP 不是给 gym owner 用的。Gym owner 不会装 Claude Desktop。

正确定位：MCP Server 是面向合作伙伴、顾问、集成商的 AI-native API。

场景示例：

• 健身房顾问在 Claude.ai 里问 "Show me gym ABC's conversion funnel this month" → Claude 通过 MCP server 查询
• 竞品分析师用 AI 工具对比多家健身房数据

现在值得做吗？ 不急。等有 10+ 合作伙伴客户再考虑。优先做 #1-#4。

##9 自动 SMS 发送

Level 5 自动化。暂不建议。

前提条件：实时监控、Kill-switch（5 秒内暂停）、审计日志、A/B 测试框架、法律审查。

过渡方案（Level 4.5）：AI 生成推荐 → 批量审批 → 人工确认后执行。

##10 Agent SDK 内部工具

用 Claude Agent SDK（TypeScript）给团队做内部辅助工具。

适用场景：

• 数据管道故障诊断
• 跨仓库代码影响分析
• 自动化 on-call runbook

不适用于客户产品。优先级低。

#六、5 级自动化金字塔

不需要按顺序走。可以跳过 L3 先做 L4（用规则代替预测模型）。

详见 产品本质 / North Star 与五层能力金字塔(L1 Describe → L5 Execute)。

#七、关键技术决策

#八、推荐执行顺序

Phase 1 (当前 → 4 周):   L1 Dashboard 洞察 + 内部 Skills 整理
Phase 2 (4-10 周):       L2 AI 诊断对话 + Staff Coaching 增强
Phase 3 (10-20 周):      L4 Campaign Engine MVP (AI 推荐 + 人工审批)
Phase 4 (20-32 周):      L3 Churn 预测模型 + L4.5 半自动执行
Phase 5 (32 周+):        L5 全自动化 + MCP 生态开放

#成本估算

Claude API 使用成本：每月约 500K-2M tokens，$15-60/月。在总成本中可忽略。

#附录：竞品 AI 能力对标

::: details 健身房 AI 竞品（点击展开）

Keepme（健身房 AI 留存）

• Keepme Score：Random Forest 算法，100 万+ 决策树，流失预测准确率 95%
• 追踪指标：到访频率、课程多样性、续费行为、会员互动
• 自动化：对分群后的高风险会员自动触达

retaintive vs Keepme：

通话中心 AI Coaching 竞品

这些产品验证了 AI coaching 的市场需求。retaintive 的差异在于垂直行业（健身房）+ 全链路数据（通话 + Lead + SMS + 到访）。