前言¶
在金蝶 ERP 里手工建零散物料，常见流程是：从申购单或零散物料清单里逐行抄规格，再对照「导入模板.xlsx」填满 71 列，并自己维护 A/B/C 等系列编码的流水号。多张单子并行时，同一物料容易被重复建码；申购单上的编码列若在未确认导入成功前就写入，一旦金蝶侧失败，回滚和核对成本都很高。
下面介绍 SkillHub 上的社区 Skill「零散物料导入模板生成」（@user_d201725d/misc-material-import，当前版本 v1.8.5）。它把「提取待新建行 → 按模板列生成 xlsx → 接续系列编号 → 跨单去重」交给 Agent 按 SKILL 规则执行，并把申购单编码回填限定在「金蝶全部导入成功并确认之后」。
这是什么¶
一句话定位：金蝶 ERP 零散物料专用的导入模板生成工具，输出符合 导入模板.xlsx 71 列格式的可导入 .xlsx。
- 维护方：SkillHub 社区发布者
user_d201725d（页面标注作者为莫佩琪），来源为 community，分类office-efficiency。 - 解决的问题：从零散物料清单（
.xls）或申购单（.xlsx）中识别需要新建的物料行，生成金蝶可导入文件，并自动接续A.XXX.YYYYY、B.XXX.YYYYY、C.XXX.YYYYY、D.XXX.YYYYY等系列编号；相同物料跨多张单子只保留一个编码（自动去重，无需人工确认是否合并）。 - 依赖：标签标明
requires_api_key=false，不强制额外 API Key。
官方页面：https://www.skillhub.cn/skills/user_d201725d/misc-material-import
Skill 坐标：@user_d201725d/misc-material-import
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，可按条目核对。
输入与输出格式¶
- 输入：零散物料清单（
.xls），或申购单（.xlsx）。 - 输出：按「导入模板.xlsx」71 列结构生成的
.xlsx，可直接用于金蝶物料导入。
编号与去重¶
- 在既有 A/B/C/D 系列规则下自动接续编码（格式为
A.XXX.YYYYY及 B/C/D 同类模式）。 - 自动跨单去重：多张来源单里规格相同的待建物料只生成一个物料编码，避免重复建档。
校验与回填策略¶
- 未知分组硬校验：遇到无法识别的分组会直接中止，避免生成错误列或错系列数据（需先修正源表或 Skill 规则后再跑）。
- 申购单编码「确认后回填」：生成导入模板时不会自动把编码写回申购单；应在用户确认金蝶侧全部导入成功后，再从导入模板读取「物料 ↔ 编码」映射，回填申购单中仍为空的编码列。这样与「先导入、后落单」的实务一致，减少未成功导入却已回填的风险。
触发方式¶
在支持 Skills 的 Agent 中，可用自然语言或下列触发词唤起（与官方简介一致）：
- 零散物料导入、零散物料未匹配
- 零散物料 A/B/C 系列导入、A 系列导入、C 系列导入
- D 系列导入、劳保用品导入
安装与启用¶
Skill 基于通用 SKILL.md 格式。安装前需本机已有 SkillHub CLI；若尚未安装，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不被识别。示例：
skillhub install @user_d201725d/misc-material-import --dir <你的 Agent skills 目录>
常见路径（以 SkillHub 安装文档为准，按你当前客户端择一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给已接入 Skill 安装的 AI，让其按官方流程安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_d201725d/misc-material-import。
安装后按你所用客户端要求刷新或重启 Agent，使新 Skill 被加载。
典型用法¶
官方页面未给出固定 CLI 子命令，实际执行由 Agent 读取 Skill 内规则完成。可复现的操作顺序如下。
- 准备源文件：整理好当批零散物料清单（
.xls）或申购单（.xlsx），并确保本机有与金蝶一致的导入模板.xlsx列定义（71 列）供 Skill 对齐。 - 唤起 Skill：在对话中说明要做「零散物料导入」，或直接使用上文触发词（例如「零散物料 A/B/C 系列导入」「零散物料未匹配」）。
- 指定文件：明确告知 Agent 源文件路径；若有多张申购单，说明是否同一批次合并处理（跨单去重会在 Skill 规则内生效）。
- 检查生成结果：打开输出的导入用
.xlsx，核对系列编号是否按 A/B/C/D 规则接续、待建行是否与源表一致；若遇未知分组，按提示修正源数据后重新生成。 - 金蝶导入与回填：在金蝶中完成导入并确认全部成功后，再让 Agent 按 Skill 的「确认后回填」规则，从导入模板读取编码映射，写回申购单空编码列——不要在仅生成模板、尚未导入成功时要求自动回填。
适用场景与注意¶
适合谁
- 使用金蝶 ERP，零散物料建档频繁、源数据来自 Excel 清单或申购单的实施、物控或 IT 支持人员。
- 已在使用 Cursor、Claude Code、Codex 等支持 SkillHub Skills 的 Agent，希望把重复填表和编流水号交给规则化 Skill。
限制与注意
- 输出列结构绑定 71 列导入模板；模板版本或金蝶字段变更时，需同步 Skill 侧规则或模板文件。
- 未知分组会中止：比静默写错更安全，但需要维护好源表分类/分组字段。
- 社区 Skill（v1.8.5），下载与评分以 SkillHub 为准（页面统计：下载约 1120、评分 100000）；业务路径、默认输出文件名等以 Skill 包内
SKILL.md为准，部署前应在测试环境跑通一整条「生成 → 金蝶导入 → 确认后回填」。 - 跨单去重以「相同物料」判定为准，具体字段匹配逻辑在 Skill 文档中；若有特殊规格区分需求，生成后应人工 spot check。
结尾¶
「零散物料导入模板生成」把金蝶零散物料最常见的 Excel 手工链路收成「提取 → 71 列模板 → 系列编号接续 → 跨单去重」，并把申购单编码回填卡在导入成功之后，适合作为 Agent 工作流里的一步而不是替代金蝶里的最终审核。
安装与说明见 SkillHub 官方页：https://www.skillhub.cn/skills/user_d201725d/misc-material-import
