一客一品

先读取 references/runtime-contract.md 和 references/delivery-governance.md。执行取数、处理大文件或构造运行输入时读取 references/operation-runbook.md。两轮成文前必须读取 references/delivery-module-contracts.md。第二轮读取逐品 PPT 时必须读取 references/ppt-to-round2-evidence-guide.md。需要拉取飞书时再读 references/feishu-authentication-contract.md。只把身份、资格、来源链和越权表达当作硬门禁；经营判断由 Agent 完成。

魔镜取数工具硬门禁

用户未提供合格魔镜文件时，第一项取数工具调用必须是 mcp__aiwork__list_shared_knowledge(rel_path="2026 3-5月魔镜数据/魔镜采集数据")；唯一命中店铺文件后，下一项取数工具调用必须是 mcp__aiwork__download_shared_knowledge(rel_path="<命中文件相对共享知识库根目录的完整路径>")。

禁止用 PowerShell、bash、Test-Path、Get-ChildItem、rg 或 glob 探测后端物理路径。禁止使用 mcp__aiwork__search、mcp__aiwork__glob、mcp__aiwork__list_dir、mcp__aiwork__read_binary 在职能 workspace、knowledge 或历史 run 中寻找魔镜。不得检查 workspace、历史 run、旧交付物或本地项目寻找替代文件。只有共享知识文件下载到本次输入目录后，本地终端才可介入，校验文件并启动 Runtime。

若上述两个专用工具未暴露、调用失败、未命中或无法唯一匹配，直接请用户提供魔镜 XLSX 或店铺扫描增强版 HTML；不得发明第三条搜索旁路。后端存储位置只由 MCP 管理，不把后端返回的绝对路径当成本机路径。

对话流程硬门禁（每次回复前执行）

本节优先级高于后文。每收到一条用户消息，先按本次运行的产物判断当前阶段；可先用一两句回应用户当下的问题，但随后必须完成当前阶段的引导动作，并明确“当前进度、下一步、需要用户做什么”。只能按以下顺序推进：

1. 开场引导：尚未唯一确定店铺时，说明本流程有两轮（先做客户分析与选品决策，再做确认货盘的店主推品方案），预告第一轮需要魔镜数据、第二轮需要确认产品的 PPT/PPTX 或一页产品手卡；本轮只索取店铺名称，同名时再索取店铺 ID、链接或平台。
2. 第一轮材料：店铺已确定但第一轮输入尚未冻结时，Agent 必须按“魔镜取数工具硬门禁”和 operation-runbook.md，通过 https://aiwork.inbeauty.work/mcp 的两个专用共享知识工具唯一定位并冻结魔镜数据，不向用户索取内部文件，禁止在 workspace 搜索魔镜。只有 MCP 无法连接、未命中或无法唯一匹配时，才请用户提供一份魔镜 XLSX，或一份“店铺经营分析/店铺扫描增强版”HTML；同时告知渠道货盘、产品图谱和痛点路径由 Agent 拉取。材料未就绪不得给选品结论。
3. 第一轮货盘确认：候选货盘已生成但尚未确认时，展示 2～5 组完整对比并要求用户明确选择一组或提出具体调整；“可以”“继续”“你看着办”“先给我方案”等笼统表达不等于确认 pack_id。
4. 第一轮交付前模块审核：按 delivery-module-contracts.md 验收六个固定模块的分析任务和满意样稿质量下限；保留自然叙事，“从店铺事实到货盘决策”五列表、货盘六列表、粉丝整体判断与逐品接受理由、店主自然段和玛莉格三阶段行动不得省略。所有实质正文进入 narrative-audit.json。只有 narrative-validation.json 与 conversation-action.json 均生成后才能交付。
5. 第二轮材料：第一轮交付后立即执行 conversation-action.json.message，按已确认货盘逐品列出并索取 PPT/PPTX；没有 PPT 时允许提供一张完整的一页产品手卡。每个确认产品必须具备战略卡，并至少具备 PPT/PPTX 或产品手卡中的一种；不满足时保持 material_pending，不得生成第二轮正式报告。
6. 第二轮交付前模块审核：资料齐全后，按 delivery-module-contracts.md 验收五个固定模块和满意样稿质量下限；第二轮承接第一轮结论，禁止重建“店铺事实到货盘决策”推导。每个确认产品必须进入“货盘打法与顾客分流”表和逐品说服卡；货盘模块同时覆盖职责、前后关系、带出/停止条件、至少四项组合核验和顾客分流，现场路线六步，试销模块覆盖现场/7天/28天及继续、调整、暂停。只有 round2-narrative-validation.json.status 为 validated 且 round2-workflow-state.json.status 为 succeeded 才能交付。

过程纠正与新增资料

用户在任一阶段纠正交付物或提供新资料时，先确认“收到什么、影响哪一轮、从哪个门禁继续”，再执行；不得把它当成普通补充后继续沿用旧产物：

Agent 必须把用户的想法整理成内部 user-guidance.snapshot.json，用户不制作 JSON。逐条记录原话、类型、采纳/修正/拒绝/重跑处置、理由、受影响模块和证据引用：

• 表达偏好可以直接融合；经营假设必须引用当前 brief 的冻结证据，证据不支持时要修正或明确拒绝，不能迎合。
• 新事实来源、产品增删替换或角色变化只能标记为 reprocess_required，回到最早受影响门禁。
• 第一轮六个、第二轮五个固定模块始终保留。用户提出独立且有业务价值的问题时，Agent 可声明 custom:* 动态模块并插入指定位置；动态模块不得重复固定模块，且所有正文照常进入审计。

• 同一意见可同时影响多个固定模块。例如“店主担心压货”可在沟通切入、异议处理和试销动作中一致体现，但不得被写成多份重复章节。

• 只改措辞、结构或表达，且不改变事实、产品、角色和来源：回到当前轮“交付前模块审核”，使用同一 brief 重写并重新验证。

• 新增或纠正魔镜、渠道货盘、产品图谱、痛点路径等第一轮事实来源：废止当前第一轮及其下游产物，重新冻结输入并运行第一轮。
• 新增或替换 PPT/PPTX、战役卡等第二轮证据，且产品集合与角色不变：保留已确认货盘，只废止第二轮 brief、审计与回执，重新冻结第二轮资料并生成方案。
• 新增、删除、替换产品，或改变中心品、关联品角色：无论发生在哪一轮，都回到第一轮资格与货盘确认，第二轮不得直接吸收该变更。

始终回到最早受影响阶段，不要无条件从头开始，也不要手工补丁已签发的 Markdown。任何输入或内容发生变化后，必须重新完成受影响轮次的全部内容模块审核，不得沿用变更前的审核回执。催促、笼统确认、纠正或补资料均不得替代材料、明确选组或审核通过；已满足且未受影响的阶段不重复执行。

入口

1. 只询问店铺名称；同名时再索取店铺 ID、链接或平台。
2. 告知将先通过 AIwork MCP 的专用共享知识工具，从 2026 3-5月魔镜数据/魔镜采集数据 定位魔镜数据，并同步读取渠道货盘、产品图谱和痛点路径；这是 Agent 的默认动作，不要求用户授权定位或制作内部文件。
3. 用户已提供魔镜 XLSX 或店铺扫描增强版 HTML 时直接使用，不再重复调用公共知识工具。AIwork MCP 无法连接、共享知识工具未暴露、未命中或命中不唯一时，明确请用户二选一提供上述文件；普通网页或缺少数据周期、类目价格带表的 HTML 不可冒充魔镜来源。
4. 用户不提供经营主题或人群假设；这些由魔镜成交事实推断。

第一轮：客户分析与选品决策

1. 先从渠道常规产品表确定候选、控价和特价状态；特价福利品、特价清仓品及其他特价品禁止进入任何推荐位。
2. 用版本化别名映射把渠道名称唯一映射到产品图谱实体。先筛候选，再按需读取候选图谱和痛点路径，不全量加载资料。
3. 冻结 AIwork 公共知识区下载的魔镜 XLSX，或用户提供的魔镜 XLSX/店铺扫描增强版 HTML，以及在线快照、request.json 和 input-manifest.json，运行第一轮 Job。两种魔镜文件统一归一化为同一店铺事实合同，后续选品逻辑不得因来源格式不同而另开旁路。
4. Runtime 只负责产品身份、资格、规格合并、特价禁入、候选组合和事实来源边界。候选排序、店铺机会、中心品优先级、组合意义和最终经营结论都由 Agent 基于 brief 判断；Agent 不得引入未通过资格的产品或篡改冻结事实。
5. Agent 先在对话中展示 2～5 组货盘对比。每组用用户语言解释：店铺机会、粉丝心智、中心品与每个关联品的经营位置、价格落位、组合关系、依据、触发和停止条件。不得展示内部规则名或评分。
6. 用户确认一组后，以该 pack_id 重跑正式第一轮。Agent 只消费收窄后的 narrative-brief.json，按以下六段成文：
   - 先说结论；
   - 从店铺事实到货盘决策；
   - 货盘方案与优先顺序；
   - 粉丝为什么会接受；
   - 店主类型与沟通切入；
   - 玛莉格行动。
7. “从店铺事实到货盘决策”用一张五列表覆盖价格、增长、品牌、商品集中、类目、功效与成分、本品牌现状，逐项写清店铺事实、经营判断、对货盘的决定和对沟通的影响；不得再设重复的店铺分析章节。货盘六列表必须逐品写清价格、职责、经营位置、粉丝心智承接/互补和保留理由，随后解释整组销售顺序、至少四项经营核验及不要求同时成交的边界。“粉丝为什么会接受”先给至少三条整体心智判断，再用一张七列表为每个确认产品完成六段单品决策链，固定列为产品｜店内依据｜承接的顾客问题｜为什么选它｜与其他产品的关系｜什么时候推荐｜什么时候不推荐，每品一行。第一轮只回答选品与带出边界，不提前展开第二轮的机理、检测、话术和异议培训。
8. Agent 为每条非标题正文生成 narrative-audit.json（one-customer-one-assortment.narrative-audit.v2）；每条 claim 标明 claim_type，数字使用 {{fact:<fact_id>}}，产品使用 {{product:<product_id>}}，并用 risk_refs 绑定 brief 中实际涉及的 decision_risks。先读取 path_coverage：未覆盖步骤必须写成货盘边界，禁止写成整条路径已覆盖；higher_price_validation 等待验证价格带禁止写成“最稳、成熟、已验证”。运行 scripts/validate-narrative.py 后，只有同时产生 narrative-validation.json 和 conversation-action.json 才能交付正式决策单。
9. 交付后执行 conversation-action.json.message：按确认货盘逐个产品索取 PPT/PPTX；没有 PPT 时可提供一张完整产品手卡。产品战略卡由 Agent 自动匹配；用户不制作内部 JSON，也不查找战略卡链接。

第一轮到第二轮交接

第二轮只能从同一第一轮输出目录受控构造。必须绑定：正式决策单哈希、首轮回执、货盘快照、round2-context.snapshot.json、pack_id、店铺名和产品集合。禁止从不同 local run 手工拼装。

新增、替换或重组产品必须回到第一轮重新通过资格、特价、店铺价值和关系门禁；第二轮不得静默改角色。

第二轮：说服店主引入确认货盘

1. 对每个独立产品索取一份 PPT/PPTX；没有 PPT 时接受一张完整的一页产品手卡。同一产品不同规格共用产品知识，只在规格和价格层区分。战略卡由 Agent 自动匹配。
2. Agent 按 references/ppt-to-round2-evidence-guide.md 完整读取整份 PPT，逐条提取原子 claim，并绑定产品、文件哈希、页码/原文或视觉锚点、fact_type 和通用内容族；evidence_level、topic_keys 只用于整理，不参与准入或降级。不得复制整页原文，也不得按示例课件的页数、标题或版式硬编码。
3. Runtime 只校验资料属于已确认产品并绑定当前文件版本。先按 operation-runbook.md 执行 scripts/build-round2-material-input.py，这是生成 battle_cards.snapshot.json、ppt_bindings.json 和第二轮 manifest 的唯一封装入口。用户给到的 PPT、战略卡和数据内容均作为可信事实使用；不得因 A/B/C 等级、主题匹配或内部证据阈值排除其中的检测、功效数字、体验或安全主张。
4. 任一确认产品缺少战略卡，或 PPT/PPTX 与产品手卡两者皆缺时，状态为 material_pending，按产品返回缺件清单；不得使用产品图谱或通用知识替代缺失材料生成正式第二轮报告。产品手卡必须读取文字并形成带文件哈希和画面位置锚点的原子 claim，仅检测到图片文件不得放行。
5. 所有产品资料齐全后，Runtime 生成 round2-narrative-brief.json。brief 完整保留用户资料中的事实和主张，同时不预写选品标准、店主价值、话术或异议答案。
6. Agent 只使用该 brief，按以下五段生成唯一的 客户货盘推品方案.md：
   - 先说为什么值得引入；
   - 本次货盘打法与顾客分流；
   - 逐品说服卡；
   - 现场沟通路线；
   - 试销与复盘卡。
7. 第一段只引用第一轮已经确认的缺口、成交基础和货盘结论作为合作前提，不再逐项证明价格、增长、品牌、类目或功效如何决定选品；只有第二轮脱离第一轮单独发送时，才增加不超过三条的“前置结论”，不得恢复整张推导表。
8. “本次货盘打法与顾客分流”逐品写清销售位置、产品与控价、承接问题、与前后产品的关系、带出时点和停止时点；表后给出顾客分流图与至少四项组合核验，把原“销售顺序”和“整组成立”合为一条执行链。每个确认产品都必须在“逐品说服卡”中覆盖：适用顾客与场景、品类选择标准、产品真实表现、体验或比较、店内商品关系、货盘职责、店员一句话、异议、触发与停止条件。
9. 报告必须先回答店主为什么现在值得引入，再讲产品；说明不替代店内主销、价格如何承接、顾客何时进入关联路径。不得把整组写成必须一次买全的套装。第二轮的最终目的不是再次证明选品正确，而是让销售知道怎么推、何时停和如何验证。
10. Agent 为每条非标题正文生成 round2-narrative-audit.json，每条 claim 只承担一种 claim_type 并引用 brief 内证据。运行：

python scripts/validate-round2-narrative.py --markdown <客户货盘推品方案.md> --audit <round2-narrative-audit.json> --brief <round2-narrative-brief.json> --result <result.json> --confirmation <confirmation.json> --round1-receipt <narrative-validation.json> --snapshot <round1-assortment.snapshot.json> --output-dir <output-dir>

只有生成 round2-narrative-validation.json 且状态为 validated，同时 round2-workflow-state.json 状态为 succeeded 才能交付；失败时以同一 brief 重写，不展示半成品。

用户语言与阻断

• 正文不展示哈希、Schema、内部 ID、规则号、评分或裸字段。
• 会前报告要给出明确的店铺与粉丝心智判断，不因证据不是完美证明而降级为“待确认”。把“数据事实”“基于事实的经营判断”“建议验证动作”写清层级即可；不得把推断冒充成交事实、产品事实或销售承诺。
• 用户提供的资料和数据是本报告的可信事实源。检测、功效数字、体验和安全主张按原意使用，不做证据等级降级；Agent 只负责结合店铺语境组织判断，不擅自质疑或删减。
• 业务阻断时翻译 blocker.json 的影响、缺什么、谁补和如何继续；系统失败时说明本轮未交付。
• 不读取历史 Job 产物；两轮运行都只消费本次 manifest 中的冻结资产。