Agent Skills
返回列表
MDF 扩展开发助手

MDF 扩展开发助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_be70aa17/test-skill。

技能介绍

要解决的问题

MDF 单据页面扩展开发常卡在几个具体环节：工作区里有多个前端工程，先要确认哪个是真实 MDF 工程根；.yoncode/ 下的 UI 元数据 XML 需要解析，但不能凭记忆猜字段和 cSubId；扩展脚本要落在原厂或客开目录，文件名、对象名、事件入口都容易错；生成代码后还要确认每个框架 API 都在白名单里，避免使用废弃或不存在的方法。

技能如何工作

该技能按一条可复核的工作流执行：

  • 工程环境检测：优先用 scripts/detect_target_project_root.py 锁定唯一工程根，区分原厂和客开目录结构。
  • UI 元数据解析：使用 yct dsl index 读取 .yoncode/{domain}-meta/{appCode}/ui/*.xml，需要节点详情时用 yct dsl detail。
  • 落点定位与可行性判断：根据 cSubId、cBillNo、cBillType 判断扩展入口，并判断需求能否由扩展脚本实现。
  • 代码生成：基于 assets/ 模板、API-INDEX.md 和 API-WHITELIST.md 生成 *.Extend.js 或客开扩展脚本，而不是自由发挥。
  • 校验与调试：逐项比对 API 白名单，输出通过/不通过的问题清单，或生成本地调试上下文。

适用边界

它面向 MDF 单据页面的前端扩展脚本开发，不替代后端元数据管理，也不负责协议拉取、协议摘要生成或设计评审。UI 元数据缺失时，工作流可能会尝试 yct metadata search 拉取到 .yoncode，但拉取失败仍需要提供 domain 和 appCode。

使用场景

  • 在多前端仓库中确认 MDF 工程根，并判断当前目录属于原厂还是客开扩展结构。
  • 读取 .yoncode 下 UI 元数据 XML，解析 cSubId、cBillNo 和控件类型，定位扩展落点。
  • 为 MDF 单据页新增保存校验、字段联动或按钮逻辑，生成符合白名单的扩展脚本。
  • 扩展脚本未生效时，回读文件、校验 API 白名单并生成本地 debug 上下文排查。

适合人员

  • 负责 MDF 单据页二开的工程师，需要按元数据生成扩展脚本并避免使用非白名单 API。
  • 接手客开项目的工程师，需要快速判断当前目录是原厂还是客开结构并找到扩展入口。
  • 做前端调试的工程师，需要扩展未生效时依据文件、白名单和调试上下文排查原因。
  • 需要评估 MDF 页面改造可行性的工程师，要先基于 UI 元数据判断能否用扩展脚本实现。