# Kam Qianlu Doc Standards

> 千路订单管理系统的文件执行标准。Returns table header standards and file naming rules for import/export (quotation, rfq, reply, order, purchase). When user provides an Excel and a document type, offers to verify headers and suggest a compliant filename; if accepted, validates and normalizes headers and renames the file. Use when user asks for 表头标准、导入要求、导出格式、命名规则、文件执行标准, or when user uploads/shares an Excel and says 这是回询单/询价单/报价单/订货单 and wants header verification or filename correction.

- Skill: `dvcrn/kam-qianlu-doc-standards` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/kam-qianlu-doc-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/kam-qianlu-doc-standards/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/kam-qianlu-doc-standards

---


# kam-qianlu-doc-standards — 订单管理系统文件执行标准

本 SKILL 定义**千路订单管理系统**的单据**文件执行标准**：表头规范与文件名命名规则。提供两类能力：**① 返回各类导入/导出文件的表头标准与命名规则**；**② 根据用户提供的 Excel 与单据类型，核验表头并建议/执行文件名与表头整理**。权威数据以同目录 [REFERENCE.md](REFERENCE.md) 为准，与项目 `docs/naming-and-terminology.md`、`shared/utils.py`、`server/services/order_import_service.py` 等一致。

---

## 功能一：返回表头标准与命名规则

当用户询问以下任一内容时，使用本 SKILL 并依据 **REFERENCE.md** 回答：

- 询价单 / 报价单 / 回询单 / 订货单 / 采购单 / 问价单 的**导入表头要求**或**导出表头格式**
- **文件名命名规则**（如「报价单怎么命名」「订货单文件名格式」）
- 某类单据「可识别的列名」「必填列」「推荐表头」
- **订单管理系统文件执行标准**、**单据规范**

**操作**：

1. 打开并引用 [REFERENCE.md](REFERENCE.md) 中对应章节（文件名规范、询价单导入、报价单导入、问价单导出、回询单导出、订货单导入、订货单导出、采购单导出、采购单回传等）。
2. 用简洁表格或列表给出：标准表头/推荐列名、可识别别名、必填项、文件名格式与示例。
3. 若项目内还有 `docs/naming-and-terminology.md`、`docs/functions/process-and-rules.md`，可提示用户进一步查阅，但以 REFERENCE.md 为本 SKILL 的单一数据源，避免重复维护。

---

## 功能二：核验表头并整理文件名（用户提供 Excel）

当用户**上传或提供 Excel 文件路径**，并说明**单据类型**（如「这是回询单」「这是订货单」「这是报价单」）时：

### 步骤 1：确认意图

回复中**必须**询问用户：

> 是否需要我**核验表头是否符合导入/导出要求**，并**根据规范建议或修改文件名**？若需要，请回复「是」或「核验」。

若用户未提供单据类型，先根据文件名或内容推断可能类型，并反问确认（例如：「从文件名看像是订货单，请确认是 询价单 / 报价单 / 回询单 / 订货单 / 采购单回传 中的哪一种？」）。

### 步骤 2：用户确认「是」后的处理流程

1. **读取 Excel**  
   使用项目环境可用的方式（如 Python + openpyxl）读取用户提供的 .xlsx：定位表头行（前几行中含「品牌」或 "brand" 的行，或第 1 行），获取当前表头列表。

2. **确定标准**  
   根据用户指定的单据类型，从 [REFERENCE.md](REFERENCE.md) 取对应「导入」或「导出」表头及可识别别名。

3. **核验表头**  
   - 必填列是否都存在（可识别别名视为存在）。  
   - 当前表头与标准/别名的对应关系：哪些已合规，哪些需「改名」才符合系统识别。

4. **整理表头**  
   - 对可识别的列：若当前名与标准名不一致，建议改为 REFERENCE 中的**推荐标准列名**（或导出标准表头），以便系统导入时识别。  
   - 输出「当前表头 → 建议表头」的映射表；若用户同意，生成修改后的 Excel（仅改表头行）或给出明确修改步骤。

5. **文件名**  
   - 根据 REFERENCE 中的「文件名规范」与用户提供的单据类型，建议合规文件名（例如订货单：`订货单-XXXX-日期.xlsx`）。  
   - 若用户同意，可重命名文件并返回新路径或新文件。

6. **返回结果**  
   - 简要报告：表头核验结果（通过/需修改项）、建议表头映射、建议文件名。  
   - 若已生成新 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](REFERENCE.md) 为准；项目术语以 `docs/naming-and-terminology.md` 为准。*