前言¶
制造企业里「一物多码」很常见：同一物料在 ERP、PDM 里有多条编码，采购和库存对不上，人工比对又慢又漏。做「企业物料智能去重与数据治理」这类系统时，前端要批量调接口、后端要同步 ERP/PDM，还要把任务公平分给数据员——通用编程提示往往不够贴业务。下面介绍 SkillHub 上的社区 Skill「数据治理平台-机械制造」（坐标 @user_480293a4/shujuzhili-nz），它把 SimilarityCheck 相关项目的开发约定整理成可检索的 SKILL.md 与子文档，方便在 Cursor 等 Agent 里按场景引用。
这是什么¶
一句话定位：面向「企业物料智能去重与数据治理系统」的开发最佳实践技能包（技能包内名称为「SimilarityCheck 数据治理开发最佳实践」），不是独立运行的数据治理 SaaS。
维护与来源：SkillHub 社区发布，发布者 user_480293a4，版本 1.0.0，分类 data-analysis，来源 community。页面标注 requires_api_key=false，安装后无需额外 API Key。
解决的问题：把性能优化、需求确认、调试、异步与数据同步等 10 类反复出现的工程问题，写成「问题 → 反例 → 正例 → 模板 → 检查清单」结构，减少在 Vue3 + Flask 技术栈上重复踩坑。
核心功能¶
技能包入口 SKILL.md 声明覆盖 10 个子技能，均可单独打开对应 Markdown 让 Agent 遵循：
| 序号 | 主题 | 要点（据技能包原文） |
|---|---|---|
| 01 | 性能优化-批量请求分批处理 | 避免 Promise.all 一次并发过多导致浏览器卡死，采用分批执行 |
| 02 | 性能优化-高频计算缓存 | computed 与渲染函数中复杂计算的缓存策略 |
| 03 | 显示逻辑-统一管理 | 前端展示逻辑集中维护 |
| 04 | 边界情况-充分考虑 | 识别并处理边界条件 |
| 05 | 需求理解-充分确认 | 接需求后的确认流程，降低理解偏差 |
| 06 | 调试技巧-清晰错误信息 | 提升错误信息可读性，便于定位 |
| 07 | 代码验证-修改后验证 | 改码后的验证流程与 checklist |
| 08 | 代码规范-关键逻辑注释 | 关键业务逻辑的注释规范 |
| 09 | 数据同步-结构变化更新 | 数据结构变更时的同步更新策略 |
| 10 | 异步处理-正确操作 | async/await 用法与竞态规避 |
技术栈（技能包声明）：前端 Vue 3、Element Plus、Vite；后端 Flask、Python 3、SQLAlchemy；数据库 SQL Server；开发辅助提及 WorkBuddy AI。
业务背景（技能包项目说明）：系统通过相似度匹配发现重复物料，将任务分配给数据员，并同步状态到 ERP/PDM。技能包内附有量化描述（如重复发现率、采购节约区间等），实施前请结合本企业数据自行核验，不宜直接当作对外承诺数字。
安装与启用¶
方式一：按 SkillHub 页面提示交给 Agent¶
SkillHub 技能页给出的安装提示为：请根据 SkillHub 安装文档，安装 @user_480293a4/shujuzhili-nz。
方式二：使用 skillhub CLI¶
先确认本机是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（示例为文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录。社区技能的 slug 为 shujuzhili-nz，需带 namespace：
skillhub install shujuzhili-nz --namespace user_480293a4 --dir ~/.cursor/skills/
说明：
- Cursor：skills 目录一般为
~/.cursor/skills/（与 SkillHub 安装文档 一致）。 - Claude Code：文档列为
~/.claude/skills/。 - Codex：文档列为
~/.codex/skills/或项目下的.agents/skills/。
安装完成后，在对话中涉及物料去重、任务分配、批量接口或数据同步等开发问题时，Agent 可加载该技能包下的 SKILL.md 与对应编号文档。
典型用法¶
技能包建议的使用流程如下：
- 根据当前开发阶段选择子技能文件（如正在改批量接口，打开
01-性能优化-批量请求分批处理.md）。 - 按文档中的结构对照：问题描述 → 错误示例 → 正确做法 → 通用模板 → 检查清单。
- 用检查清单逐项确认后再合入代码。
示例（摘自子技能 01，批量保留接口）：对大量分组调用 /set-retain 时，不要一次性 Promise.all 全部请求，而应按批（文档示例 batchSize = 5）执行，必要时在批次间增加短延迟：
const batchSize = 5
for (let i = 0; i < setRetainPromises.length; i += batchSize) {
const batch = setRetainPromises.slice(i, i + batchSize)
await Promise.all(batch.map(fn => fn()))
if (i + batchSize < setRetainPromises.length) {
await new Promise(resolve => setTimeout(resolve, 100))
}
}
示例（摘自子技能 05，需求确认）：接到「多 PDM 冲突组全部给某数据员」类需求时，先用复述 + 追问（组定义、人数上限、显示规则、边界分配）让用户确认，再实现，避免返工。
适用场景与注意¶
更适合谁
- 正在维护或二开「物料智能去重 / 数据治理 / 任务分配」类系统，且技术栈与技能包声明接近（Vue3 + Flask + SQL Server）的团队。
- 希望把项目里沉淀的规范交给 Agent，而不是每次从零口述的团队。
限制与注意
- SkillHub 列表名称为「数据治理平台-机械制造」，技能包内标题为「SimilarityCheck 数据治理开发最佳实践」，检索时两个名称都可能出现。
- 公开技能页正文较少，能力细节以安装后的
SKILL.md及 10 个子文档为准；使用skillhub install时请带--namespace user_480293a4，仅写完整 slug 而不带 namespace 时，部分环境可能下载失败。 - 据 SkillHub 元数据（抓取时点）：评分 100000，下载 988，安装 0；统计会随时间变化，以技能页为准。
- 子文档中的业务示例（如数据员姓名、PDM 冲突组规则）来自原项目语境，迁移到其他企业时需改写规则与字段，不可照搬。
结尾¶
「数据治理平台-机械制造」把制造企业物料去重场景下的工程实践拆成 10 份可引用的 Agent 技能文档，适合在 Cursor 等环境中配合 skillhub 安装使用。官方入口：
- API 坐标：https://api.skillhub.cn/user_480293a4/shujuzhili-nz
- SkillHub 页面：https://www.skillhub.cn/skills/user_480293a4/shujuzhili-nz
