kam-qianlu-doc-standards — 订单管理系统文件执行标准
本 SKILL 定义千路订单管理系统的单据文件执行标准:表头规范与文件名命名规则。提供两类能力:① 返回各类导入/导出文件的表头标准与命名规则;② 根据用户提供的 Excel 与单据类型,核验表头并建议/执行文件名与表头整理。权威数据以同目录 REFERENCE.md 为准,与项目 docs/naming-and-terminology.md、shared/utils.py、server/services/order_import_service.py 等一致。
功能一:返回表头标准与命名规则
当用户询问以下任一内容时,使用本 SKILL 并依据 REFERENCE.md 回答:
- 询价单 / 报价单 / 回询单 / 订货单 / 采购单 / 问价单 的导入表头要求或导出表头格式
- 文件名命名规则(如「报价单怎么命名」「订货单文件名格式」)
- 某类单据「可识别的列名」「必填列」「推荐表头」
- 订单管理系统文件执行标准、单据规范
操作:
- 打开并引用 REFERENCE.md 中对应章节(文件名规范、询价单导入、报价单导入、问价单导出、回询单导出、订货单导入、订货单导出、采购单导出、采购单回传等)。
- 用简洁表格或列表给出:标准表头/推荐列名、可识别别名、必填项、文件名格式与示例。
- 若项目内还有
docs/naming-and-terminology.md、docs/functions/process-and-rules.md,可提示用户进一步查阅,但以 REFERENCE.md 为本 SKILL 的单一数据源,避免重复维护。
功能二:核验表头并整理文件名(用户提供 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 为千路订单管理系统的文件执行标准;表头与命名规则以 REFERENCE.md 为准;项目术语以 docs/naming-and-terminology.md 为准。