1688 Customer Opportunity

1688 客户机会挖掘 技能 🚨 铁律（最高优先级，违反即视为流程错误）

• 命令行工具 入口路径（最先执行，路径写错直接报错）

命令行工具 入口文件：{baseDir}/命令行工具.py（{baseDir} = 技能 根目录，含 技能.md 和 命令行工具.py）。禁止 {baseDir}/scripts/命令行工具.py——命令行工具.py 不在 scripts/ 子目录。

A. 工具 输出原样输出

所有 工具 输出 JSON {"成功", "markdown", "data"}，必须完整、逐字、原样输出 markdown 字段（含 > 引用块前缀、HTML 注释、空行、表格分隔符）。禁止 精简 / 改写 / 提炼 / 合并 blockquote / 加开场白 / 从 data 重构内容。代理 的分析或追问必须放在 markdown 之后。

唯一例外：客户机会监控场景（命中触发词"最近哪些客户重要/需要主动联系的客户/待跟进客群买家"等）

调 列出_customer_cluster 时只取 data 用，禁止输出 markdown（代理 要自动取 data.列出[0].plan_id 进下一步，不展示客群表格给用户） 调 列出_cluster_buyer_detAIl 时只取 data 用，禁止输出 markdown（仅取买家 记录inId 列表喂 customer_reception_advice） 命中 "AI客群/查看客群/客群列表" 等查看客群触发词时不适用此例外，仍原样输出客群表格 A2. 全程中文输出（强制）

代理 所有面向用户的输出（含思考过程、执行步骤说明、分析、追问、工具 调用前后的描述）必须 100% 用中文。禁止任何形式的英文表述：

❌ 禁止 "Now I have..."、"Let me..."、"Per the 技能's..."、"trigger scenario"、"flow" 等英文短语 ❌ 禁止中英混排（如 "执行 列出_customer_cluster trigger" 应为 "执行 列出_customer_cluster 触发"） ✅ 技术标识符（工具 名、字段名如 plan_id/buyer_记录in_id、JSON key）保留原英文，但说明文字用中文 ✅ 思考链 / 执行步骤折叠区里的内容也必须中文（包括"查看技术细节"折叠块内的描述） A3. 三段式交付强制（所有客户机会场景的最终回答）

show_interaction 完成 action 之后，或降级输出客户名单时，最终回答必须三段：

【名单】每位 buyer_记录in_id + 身份标签（来自 credit_level / if_ka / procurement_mode） 【画像】每人的 lst_inq_time / ord_cnt_1m_level / gmv_1m_level / inq_relation 【建议】每人差异化跟进话术（来自 customer_reception_advice.sale_desc，禁止模板化复制）

🚨 强约束（违反即流程错误）：

❌ 禁止只输出"已发送"、"已执行"、"已完成"等短回复 ❌ 禁止省略其中任意一段 ❌ 禁止用列表/段落"概要"代替结构化交付（必须明确出现"名单/画像/建议"或等价的分段标题）

📌 展示时按下方铁律 A4 字段映射表翻译：本段列出的 credit_level / if_ka / lst_inq_time 等字段名仅供 代理 取值，严禁直接出现在商家可见输出里，必须翻译成「信用等级」「KA 标签」「最近询盘时间」等商家术语。

A4. 商家友好语言（最高优先级，违反即流程错误）

商家不是开发者，代理 面向商家的所有可见文字（含"正在思考中"流式区块、执行步骤说明、过渡话术、追问、错误反馈）禁止暴露任何技术内部信息。

🚨 思考过程静默原则（最强子约束）：

工具 调用前后零文字：调 工具 前不写"我要调 XXX"，调完后不写"刚刚调了 XXX"。端侧自带「📄 读取文件」「🔄 执行命令」状态卡片，代理 禁止再用文字复述同一动作。 同一句话一个 turn 内只说一次：如「商家已确认旺旺文案」「正在为你查询客群」——多步流程里只在第一步说，后续静默；连续两个流式区块说同一句即违规。 禁止流程拼盘：交付前不复盘"客群列表→买家明细→画像建议→展示交互→…"这种链路串烧——商家只想看结果，不想看你的工作流。 禁止铁律元注释：不说"现在按铁律 A3 三段式交付"「按 技能.md 第 X 步」「触发 XX 场景立即执行」等——做就行，别解释为什么做。 结果交付不加过渡话术：直接给三段式（名单/画像/建议），禁止"下面为你汇总…"「以下是…」「为你梳理…」等开场白。

❌ 禁言清单（出现即违规）：

类别 反例 工具/函数名 列出_customer_cluster、列出_cluster_buyer_detAIl、customer_reception_advice、列出_customer_detAIls、获取_cluster_marketing_plan、activate_cluster_plan、show_interaction、AskUserQuestion、customer-ww-发送、customer-sms-信息 JSON 字段/路径 data.列出[0]、plan_id、buyer_记录in_id、credit_level、if_ka、lst_inq_time、ord_cnt_1m_level、gmv_1m_level、crowd_type、cluster_name、buyer_num 等 参数/命令行工具 标志 --plan-id、--buyer-记录in-ids、--fetch-all、--crowd-type、--date-type、--gmv-1m-level 等 英文短语 "Now I have..."、"Let me..."、"Call X to 获取..."、"Per the 技能..."、"trigger / flow / scenario" 流程元注释 「我现在要…」「按 技能.md 第 X 步…」「触发 XX 场景，立即执行…」「按 M1/M2/M3/M4/M5 执行…」「公共流程 M…」「子场景 X…」「现在按铁律 A3 三段式交付…」 内部动作描述 「立即读取 activate_cluster_plan 文档」「读取 references/xxx.md」「执行开启计划」「调用 XX 接口」「商家已确认旺旺文案，立即…」「现在已 XXX，立即 XXX」——读文档 / 调接口 / 内部跳转都是 代理 自己的事 步骤链路拼盘 「所有步骤已完成：客群列表→买家明细→画像建议→展示交互→查看运营方案→确认文案→开启计划」「按以下顺序执行：①…②…③…」 交付过渡话术 「下面为你汇总…」「以下是本次客群的…」「为你梳理…」「下面是结果」——三段式直接开始，不要开场白

📖 字段翻译表 + 话术模板见 references/lang-rules.md（首次面向商家输出前必读）。

优先级： 与 A、A2、A3 同级，高于流程描述里的所有 工具 名引用——技能.md 写「调 列出_customer_cluster」是给 代理 看的指令，代理 面向商家只能说「正在查询客群」。

B. 严禁自由发挥 ❌ 主动调 获取_cluster_marketing_plan（仅在商家点 view_cluster_plan 按钮时才调） ❌ 给所有客群拉买家明细（客户机会监控只拉第一个客群） ❌ 生成长篇分析（综合策略 / 优先级排序 / 差异化话术 / 客群对比 / 附加建议等）—— 展示内容必须直接来自 工具 markdown 或 show_interaction ❌ 向 show_interaction rows 添加 spec 未定义的字段（如「所属客群」「等级」「跟进建议」） ❌ 在 show_interaction 之前用 Markdown 表格/列表"预览"买家信息 C. show_interaction 强制使用 场景 必须用 展示 ≥2 个买家供商家选择 show_interaction(name='select_buyers_from_cluster') 让商家确认/编辑客群运营方案 show_interaction(name='confirm_marketing_plan')

单买家场景（买家数 = 1）：跳过 show_interaction，直接按铁律 A3 三段式输出该买家的名单/画像/建议；有 planId 时再用 AskUserQuestion 弹「查看客群运营计划 / 换一批 / 结束」，无 planId 时弹「换一批 / 结束」，选后直接执行，不再追问。

唯一例外：买家数 = 0（无任何匹配买家）时告知"暂无数据"。

🚨 强约束（违反即流程错误）：

❌ 禁止用 Markdown 表格 / 列表 / 1. xxx 段落 / 文字描述替代 show_interaction（≥2 买家场景） ❌ 禁止说"需要我帮你..."、"以下是建议行动..."等开放式追问替代 AskUserQuestion ❌ 禁止在 show_interaction / AskUserQuestion 之前用 Markdown "汇总分析"或"高价值机会识别"长篇内容（铁律 B 已禁，再次强调） D. show_interaction 完成后处理

step 1：按 data.action.key 执行对应操作（或跳过）：

action.key 执行动作 执行后 view_plan（查看客群运营计划，有 planId 时） 进开启客群方案分支：获取_cluster_marketing_plan → confirm_marketing_plan 输入 → activate_cluster_plan 进入 step 2 next_batch（换一批，无 planId 时） 直接重新拉列表，重复 show_interaction（不进入 step 2——本身即换一批） — skip（跳过） 不执行任何操作 进入 step 2

step 2：action 执行完毕（或跳过）后，弹 AskUserQuestion：

AskUserQuestion( question="接下来怎么做？", options=[ {"label": "换一批"}, {"label": "继续跟进这批"}, {"label": "结束"} ] )

「换一批」→ 按当前场景重新拉下一组买家，重复 show_interaction 「继续跟进这批」→ 用同一份 rows/columns/actions 重新调用 show_interaction(name='select_buyers_from_cluster')，不重新拉接口 「结束」→ 告知商家跟进任务已完成，不再继续 F. 客户机会监控极简流程 列出_customer_cluster → 仅取 data.列出[0].plan_id → 列出_cluster_buyer_detAIl → customer_reception_advice（批量） → 代理 排序所有买家 → show_interaction(2列rows，传 actions=[查看客群运营计划（有planId）或换一批（无planId）]) → 按铁律 D 执行 action → 执行完后弹「换一批」/「结束」

禁止在步骤之间插入 代理 自创内容