mcpField
C
contract-cli-mdm-fields

contract-cli-mdm-fields

github.com/qfeius数据与数据库497 次安装27 周前更新
代码仓库

关于 contract-cli-mdm-fields

此技能说明如何通过 contract-cli 查询 MDM 字段配置，供写入交易方或法人实体前确认字段定义。它要求指定业务线，并区分 user 与 bot 的接口路径和支持范围。

主要功能

  1. 01按业务线查询字段配置
  2. 02支持 vendor 与法人实体字段
  3. 03区分 user 与 bot 接口路径
  4. 04说明风险字段的身份限制
  5. 05不执行本地校验或字段转换

适用场景

  1. 01写入交易方前查看字段定义
  2. 02写入法人实体前确认字段配置
  3. 03通过 user 路径查询交易方风险字段

MCP 相关

指导通过 contract-cli 查询 MDM 字段配置；user 路径使用合同 MCP 接口，bot 路径使用 MDM 接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/qfeius/contract-cli --skill contract-cli-mdm-fields

安装后在 Claude Code 中输入/contract-cli-mdm-fields确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
commands.md
schema-biz-lines.md
schema-fields-guide.md

详细介绍

来自项目 README

contract-cli MDM Fields

CRITICAL — 开始前 MUST 先读取 ../contract-cli-shared/SKILL.md。

适用命令

  • contract-cli mdm fields list --biz-line <vendor|legal_entity|vendor_risk>

快速决策

  • 需要在写入交易方前确认字段定义：--biz-line vendor
  • 需要在写入法人实体前确认字段定义：--biz-line legal_entity
  • 需要确认交易方风险字段：--biz-line vendor_risk，仅适用于 user/MCP 路径
  • 如果用户想查合同创建枚举，不要走这里，改用 contract enum list

关键规则

  • --biz-line 必填
  • mdm fields list --as user 走 /open-apis/contract/v1/mcp/config/config_list
  • mdm fields list --as bot 走 /open-apis/mdm/v1/config/config_list
  • bot 后端当前只接受 vendor / legalEntity；CLI 会把 bot 下的 legal_entity 自动映射为 legalEntity
  • vendor_risk 在 bot 身份下不支持，会在本地报错
  • --user-id-type / --user-id 仍按共享规则透传，不做本地校验
  • 当前只封装字段配置查询，不负责本地校验和字段转换
  • 推荐阅读顺序是：

实现来源

操作建议

  • 未封装写接口前，先用这条命令确认字段结构
  • 需要写交易方或法人实体时，等待对应结构化写命令开放；不要退回 api call，该入口当前暂未开放
  • 只想查合同枚举时，不要走这里

不要这样做

  • 不要把 mdm fields list 当成数据查询命令
  • 不要假设它会自动帮你校验写请求

评论

支持 Markdown