kam-qianlu-doc-standards — 订单管理系统文件执行标准
本 SKILL 定义千路订单管理系统的单据文件执行标准：表头规范与文件名命名规则；并纳入项目术语（naming-and-terminology）与流程与规则（process-and-rules）的引用，便于对术语、业务流程、数据规则等问题对答。提供三类能力：① 返回各类导入/导出文件的表头标准与命名规则；② 根据用户提供的 Excel 与单据类型，核验表头并建议/执行文件名与表头整理；③ 用户问术语、命名、业务流程、校验规则时，引用 REFERENCE.md 第十一节，打开同目录 naming-and-terminology.md、process-and-rules.md 作答或概括。权威数据以同目录 REFERENCE.md 为准（表头与文件名为第一～十节；术语与流程见第十一节）；术语与流程使用本 SKILL 目录内冗余副本 naming-and-terminology.md、process-and-rules.md，便于独立打包后不依赖项目路径即可对答。
使用流程（用户问「流程」「怎么用」时如何对答）
当用户询问流程、怎么用、如何使用、步骤时，按下列场景对答：
场景 A：只查标准（不问 Excel）
- 用户意图：想了解某类单据的表头要求或命名规则，没有提供文件。
- 回答要点：说明属于功能一，直接引用 REFERENCE.md 对应章节，给出表头/命名表格或列表；并提示「若手头有 Excel 需要核验或改名，可把文件/路径和单据类型发给我，我按功能二帮你核验并建议文件名」。
场景 B：手头有 Excel，要核验或整理
- 用户意图：已有 Excel 文件，希望核验表头是否符合系统要求，或希望得到合规文件名/表头建议。
- 回答要点：说明属于功能二，流程为：
- 确认单据类型：先确认是 询价单 / 报价单 / 回询单 / 订货单 / 采购单回传 等中的哪一种；若用户未说清，可根据文件名或内容推断并反问确认。
- 确认是否核验：明确问用户「是否需要我核验表头并建议合规文件名？」用户回复「是」或「核验」后再继续。
- 核验表头：按 REFERENCE 对应章节读取表头，检查必填列、可识别别名，给出「当前表头 → 建议表头」映射及通过/需修改项。
- 建议/修改文件名：按 REFERENCE 第一节命名规则给出建议文件名；若用户同意且环境允许，可执行重命名或输出新文件。
- 返回结果：汇总核验结果、表头映射、建议文件名及（若已处理）输出位置。
场景 C：从零到合规的完整流程（举例）
- 用户意图：想了解「客户发来一个订货单 Excel，要怎么才能导入系统？」等端到端流程。
- 回答要点：先说明文件执行标准在本 SKILL 的职责（表头 + 命名），再简述流程：
- 拿到客户/供应商的 Excel → 确认单据类型（订货单/报价单/回询单等）。
- 核验表头 → 用本 SKILL 功能二：提供文件与类型，确认核验后得到「表头是否合规、建议表头与建议文件名」。
- 按建议修改 → 用户或 Agent 按建议调整表头/文件名（或在用户同意下由 Agent 写回 Excel/重命名）。
- 导入系统 → 在系统对应页面（订货单导入/报价单导入等）上传合规后的文件完成导入。
若用户问的是系统内业务操作流程（如询价→报价→回询→订货→采购）、术语定义（如询价单与报价单区别、回询单与订货单关系）、数据校验规则（订货单如何匹配回询单、Invalid/替换号规则等），可依据 REFERENCE.md 第十一节，直接打开本 SKILL 同目录下的 naming-and-terminology.md（术语与命名）、process-and-rules.md（流程与规则） 作答或概括；本 SKILL 负责文件表头与命名，术语与流程以该两文件为准。
功能一：返回表头标准与命名规则
当用户询问以下任一内容时，使用本 SKILL 并依据 REFERENCE.md 回答：
- 询价单 / 报价单 / 回询单 / 订货单 / 采购单 / 问价单 的导入表头要求或导出表头格式
- 文件名命名规则（如「报价单怎么命名」「订货单文件名格式」）
- 某类单据「可识别的列名」「必填列」「推荐表头」
- 订单管理系统文件执行标准、单据规范
- 业务术语与命名（如询价单与报价单区别、回询单/订货单/采购单定义、替换号与报价单名等）→ 见 REFERENCE 第十一节，打开同目录 naming-and-terminology.md
- 业务流程与规则（如询价→报价→订货→采购流程、订货单如何匹配回询单、Invalid/替换号校验规则等）→ 见 REFERENCE 第十一节，打开同目录 process-and-rules.md
操作：
- 打开并引用 REFERENCE.md 中对应章节：表头与文件名为第一～十节；术语、业务流程与规则见第十一节，使用同目录 naming-and-terminology.md、process-and-rules.md。
- 用简洁表格或列表给出：标准表头/推荐列名、可识别别名、必填项、文件名格式与示例。
- 用户问术语/命名/流程/规则时，按 REFERENCE 第十一节指向上述两文档作答或概括；表头与文件名以 REFERENCE 第一～十节为单一数据源。
功能二：核验表头并整理文件名（用户提供 Excel）
当用户上传或提供 Excel 文件路径，并说明单据类型（如「这是回询单」「这是订货单」「这是报价单」）时：
步骤 1：确认意图
回复中必须询问用户：
是否需要我核验表头是否符合导入/导出要求，并根据规范建议或修改文件名？若需要，请回复「是」或「核验」。
若用户未提供单据类型，先根据文件名或内容推断可能类型，并反问确认（例如：「从文件名看像是订货单，请确认是 询价单 / 报价单 / 回询单 / 订货单 / 采购单回传 中的哪一种？」）。
步骤 2：用户确认「是」后的处理流程
-
读取 Excel
使用项目环境可用的方式（如 Python + openpyxl）读取用户提供的 .xlsx：定位表头行（前几行中含「品牌」或 "brand" 的行，或第 1 行），获取当前表头列表。 -
确定标准
根据用户指定的单据类型，从 REFERENCE.md 取对应「导入」或「导出」表头及可识别别名。 -
核验表头
- 必填列是否都存在（可识别别名视为存在）。
- 当前表头与标准/别名的对应关系：哪些已合规，哪些需「改名」才符合系统识别。
-
整理表头
- 对可识别的列：若当前名与标准名不一致，建议改为 REFERENCE 中的推荐标准列名（或导出标准表头），以便系统导入时识别。
- 输出「当前表头 → 建议表头」的映射表；若用户同意，生成修改后的 Excel（仅改表头行）或给出明确修改步骤。
-
文件名
- 根据 REFERENCE 中的「文件名规范」与用户提供的单据类型，建议合规文件名（例如订货单：
订货单-XXXX-日期.xlsx）。 - 若用户同意，可重命名文件并返回新路径或新文件。
- 根据 REFERENCE 中的「文件名规范」与用户提供的单据类型，建议合规文件名（例如订货单：
-
返回结果
- 简要报告：表头核验结果（通过/需修改项）、建议表头映射、建议文件名。
- 若已生成新 Excel或新文件名，说明输出位置与用法。
步骤 3：实现方式约定
- 表头行定位：与项目一致——前几行中首次出现包含「品牌」或 "brand" 的行作为表头行；若没有，则用第 1 行。
- 列映射：REFERENCE 中「可识别的别名/变体」均视为可接受；输出时统一为 REFERENCE 的「标准列名（推荐）」或「系统导出标准表头」。
- 修改文件：在用户明确同意且环境允许时，可写回 Excel（只改表头）或复制为新文件并重命名；若无法写回，则输出「建议表头列表」与「建议文件名」供用户自行修改。
单据类型与 REFERENCE 章节对应
| 用户说法 | REFERENCE 章节 | 核验依据 |
|---|---|---|
| 询价单 | 二、询价单（导入） | 导入表头 |
| 报价单 | 三、报价单（导入） | 导入表头 |
| 问价单 | 四、问价单（导出） | 导出表头 |
| 回询单 | 五、回询单（导出） | 导出表头 |
| 订货单 | 六、订货单（导入） | 导入表头 |
| 订货单校对版 | 七、订货单（导出·校对版） | 导出表头 |
| 采购单 | 八、采购单（导出） | 导出表头 |
| 采购单回传 | 九、采购单回传校对（导入） | 导入表头 |
简要示例
示例 1（仅查标准）
用户：「报价单导入的表头有什么要求？」
→ 引用 REFERENCE 第三节，列出推荐列名、可识别别名、报价列规则；并提示文件名规范见 REFERENCE 第一节。
示例 2（核验 + 改名）
用户：「我有个 Excel，这是回询单，你帮我对一下。」
→ 回复：「是否需要我核验表头并建议合规文件名？请回复是/否。」
用户：「是。」
→ 读取 Excel，按「五、回询单（导出）」核验表头，给出 BRAND/PARTS/QTY/PRICE/MOQ/Replace No 的对应情况；建议合规文件名（若为导出给客户，可用 回询单-{名称}-{RFQ号}.xlsx）；若用户同意，输出修改后表头或新文件及新文件名。
典型流程问答（用户问流程时可直接参考）
| 用户问法示例 | 回答要点 |
|---|---|
| 「这个 SKILL 的流程是什么？」 | 本 SKILL 有两类用法：① 只查表头/命名 → 直接按 REFERENCE 回答；② 有 Excel 要核验 → 先确认单据类型和是否核验，再按「核验表头 → 建议表头/文件名 → 返回结果」执行。 |
| 「我想查订货单导入表头，流程怎么走？」 | 属于功能一：直接引用 REFERENCE 第六节「订货单（导入）」，列出必填列与可识别别名即可，无需文件。 |
| 「我有个订货单 Excel，怎么核验成能导入的？」 | 属于功能二：先确认「这是订货单」；再问「是否需要核验表头并建议文件名」；用户确认后按 REFERENCE 第六节核验表头、第一节建议文件名（订货单-XXXX-日期.xlsx），输出映射与建议或改好后的文件。 |
| 「从拿到客户 Excel 到导入系统完整流程？」 | 见上文「场景 C」：确认类型 → 核验表头（本 SKILL 功能二）→ 按建议改表头/文件名 → 在系统对应页面上传导入。业务顺序（询价→报价→回询→订货）见 REFERENCE 第十一节 process-and-rules.md。 |
| 「询价单和报价单有什么区别？」「回询单、订货单、采购单怎么定义？」 | 属术语/命名：见 REFERENCE.md 第十一节，打开本 SKILL 同目录 naming-and-terminology.md 作答（单据与业务实体、字段与 UI 标签、易混点）。 |
| 「业务流程是什么？」「订货单怎么和回询单匹配？」「Invalid、替换号规则？」 | 属流程与规则：见 REFERENCE.md 第十一节，打开本 SKILL 同目录 process-and-rules.md 作答（交易环节流程图、数据校验规则、回询单与订货单关系等）。 |
本 SKILL 为千路订单管理系统的文件执行标准并包含术语与流程冗余副本；表头与命名以 REFERENCE.md 第一～十节为准；术语与流程以 REFERENCE 第十一节及同目录 naming-and-terminology.md、process-and-rules.md 为准，便于独立打包使用。