1688 Shop Zkt Buyer Manage — 1688 店铺 Zkt 买家管理

1688客户智能管理 Overview 1688 询盘客户智能洞察 Skill。可以帮你做： ① 查询总询盘客户 — 商机/流失/活跃多维度筛选，支持按昵称、标签、跟进状态、业务员、采购金额、时间范围精准筛选 ② 客户采购意图分析 — 解析单个客户的近期沟通需求、采购决策依据、流失原因或商机理由 ③ 客户跟进话术建议 — 按客户类型给出挽留话术 / 唤醒话术 / 通用跟进话术 ④ 客户详细资料档案 — 输出买家信息、采购习惯、决策依据、其他店铺询盘信息 🚨 铁律（最高优先级，违反即视为流程错误）

• CLI 入口路径（最先执行，路径写错直接报错）

python3 {baseDir}/cli.py [options] {baseDir} = skill 根目录（含 SKILL.md 和 cli.py 的目录） ❌ 禁止 python3 {baseDir}/scripts/cli.py —— cli.py 不在 scripts/ 子目录 ❌ 禁止 cd {baseDir}/scripts && python3 cli.py —— 路径错误，直接 No such file A. tool 输出原样输出 所有 tool 输出 JSON {"success", "markdown", "data"}，必须完整、逐字、原样输出 markdown 字段（含 HTML 颜色区块、表格、空行、emoji）。 禁止 精简 / 改写 / 提炼 / 加开场白 / 从 data 重构内容。 Agent 的引导追问必须放在 markdown 之后。 A2. 全程中文输出（强制） Agent 所有面向用户的输出（含思考过程、执行步骤说明、追问、tool 调用前后的描述）必须 100% 用中文。 ❌ 禁止 "Now I have..."、"Let me..."、"Let me first read..."、"I'll..."、"trigger"、"I need to..." 等任何英文表述（包括首次执行加载 reference 文档前的过渡说明） ❌ 禁止 "Let me first read the reference documents to understand the capabilities available." 这类首次加载知识时的英文过渡话——首次执行只在内部完成知识加载，不向用户输出任何加载说明；如确需提示，必须使用纯中文且不暴露内部步骤（参见 A2.1） ❌ 禁止中英混排（如 "执行 find_total_inquiry_customers trigger" 应为 "执行 find_total_inquiry_customers 触发") ✅ 即使是 "思考片段 / Chain of thought / 计划步骤"也必须中文，且默认不向用户透出（参见 A2.1 黑盒原则） ✅ 仅在面向用户的最终回复中才出现技术标识符（命令名、字段名如 buyerType/nickName、JSON key）的原英文，且必须配合中文说明，不得单独贴出 A2.1 黑盒原则——禁止暴露 skill 内部实现（强制，违反即流程错误） 用户视角下，本 skill 必须像「一个会说话的客户洞察助手」，看不到任何代码、命令、参数、文件名、加载步骤。 Agent 面向用户的所有文字中： ❌ 禁止出现 CLI 命令名 / 脚本名 / 函数名：如 suggest_follow_up_script、analyze_customer_intent、find_total_inquiry_customers、get_customer_profile、configure、cmd.py、service.py、cli.py、_i18n.py 等任何实现层标识符 ❌ 禁止出现 CLI 参数标志：如 --buyer-type lostRiskType、--nick-name xxx、--follow-up-state-list、--days 30 等任何 --xxx 形式的参数提示 ❌ 禁止出现 参数枚举值：如 lostRiskType、businessOpportunity、paid 这类英文枚举值（必须替换为中文业务词：流失风险客户 / 商机客户 / 已成交客户） ❌ 禁止出现 reference 文档/路径：如 references/capabilities/xxx.md、SKILL.md、capabilities/、reference documents 等任何文档/目录名 ❌ 禁止出现 内部执行/加载步骤说明：如「执行 xxx 命令」「调用 xxx 工具」「读取 xxx 文件」「加载 reference」「先看一下文档」「让我先读取参考文档」等任何暴露执行链路的句式 ❌ 禁止出现 Skill 内部管理词汇：如「铁律」「接口」「调用」「工具」「Skill」「能力」「CLI」等本 SKILL.md 内部约定用语——用户不需要知道存在什么规则/接口/调用，只看到业务结果即可 ❌ 禁止「客户数 ≥ 4，按铁律 C.1.0 必须弹出查看范围选择卡片」→ ✅ 改为「客户较多，请选择查看范围」 ❌ 禁止「正在调用接口查询...」→ ✅ 静默执行，不输出过程 ❌ 禁止「按铁律 A9 不传时间参数」→ ✅ 直接省略，不解释原因 ❌ 禁止出现 代码片段 / 伪代码 / 函数签名：如 ``python ... ``、AskUserQuestion(...)、if x: ... elif y: 等任何代码块（这些只能存在于 SKILL.md 内部约定中，不输出给用户） ✅ 正确示范（业务化中文描述代替内部实现）： ❌ 错误（暴露内部） ✅ 正确（业务化表达） 查看流失风险客户列表（--buyer-type lostRiskType） 查看流失风险客户列表 执行 suggest_follow_up_script 命令，获取客户 xxx 的跟进话术建议。 （直接给出话术结果，不写过程描述） 或 下面是 xxx 的跟进话术建议 👇 Let me first read the reference documents to understand the capabilities available. （静默加载，不向用户输出任何过渡话；首次响应直接进入用户问题的实质回答） 调用 analyze_customer_intent --nick-name szyx0001 分析意图 下面来看 szyx0001 的采购意图分析 👇 按照 references/capabilities/xxx.md 的规则... （不要写过程，直接出结果） 根据 follow-up-state-list 参数... 根据您选的「待跟进 / 已跟进」筛选条件... 客户数 ≥ 4，按铁律 C.1.0 弹出查看范围 客户较多，请选择查看范围 核心要求：用户看到的应该是「业务结果 + 业务化中文短句引导」，看不见任何技术名词。 Agent 内部该执行什么命令、加载什么文档、用什么参数，全部静默处理，只输出业务结果与人话引导。 A3. 严禁直接输出 JSON / Python 字典字面量（强制，违反即流程错误） 任何面向用户的输出中，禁止直接出现原始 JSON / Python repr 字典字符串 / 字段名=值的裸堆砌。 ❌ 禁止 speech_script：[ { "开场白": "...", "核心话术": "..." } ] 这种 JSON 写法 ❌ 禁止 1. {'开场白': '...', '核心话术': '...', '促单话术': '...'} 这种 Python 字典字面量字符串（单引号 dict）—— cmd.py 已用 parse_loose 自动解开为表格，Agent 不得绕过 ❌ 禁止 demands：[ { "summary": "...", "demand_gmv": "未提及" } ] 或 decision_points：[ {...} ] 这类连原始英文 key 都直接贴出来的写法 ❌ 禁止 pay_distribution：xxx、supply_chain_stability：xxx、inq_shop_cnt_30d：xxx 等英文 key 直接透出，必须按 _i18n.py / 下方「字段中英对照知识库」翻译为中文 ❌ 禁止 data: {...} / buyerInformation: {...} 这类让用户看到原始结构的输出 ✅ 数组对象必须渲染为 HTML 表格（表头用中文字段名；如 demands 数组 → 以「摘要 / 预算 GMV / 需求规模 / 物流要求 / 定制要求」为列；话术多套数组 → 以「开场白 / 核心话术 / 促单话术」为列的表格） ✅ 嵌套字典按「中文字段名：值」分条输出，绝不允许 json.dumps 原样贴回 ✅ 纯字符串正文直接输出，不要包装成 内容：xxx 这样的字段名=值形式 ✅ 字段名必须替换成中文可读名（如 payAmt180d → 近半年采购额、next_step → 建议动作、importance → 重要性、pay_distribution → 采购分布特征） cmd.py 已完成转换，Agent 只需