mcpField
C
contract-cli-mdm-fields

contract-cli-mdm-fields

github.com/qfeiusData & databases497 installsUpdated 27w ago
Repository

About contract-cli-mdm-fields

This skill documents how to query MDM field configuration with contract-cli before writing vendor or legal entity data. It requires a business line and explains the different user and bot endpoints and support limits.

Key features

  1. 01Query field configuration by business line
  2. 02Cover vendor and legal entity fields
  3. 03Distinguish user and bot endpoints
  4. 04Note identity limits for risk fields
  5. 05No local validation or field conversion

Use cases

  1. 01Check field definitions before writing a vendor
  2. 02Review field configuration before writing a legal entity
  3. 03Query vendor risk fields through the user path

MCP support

Guides MDM field configuration queries through contract-cli; the user path uses contract MCP endpoints, while the bot path uses MDM endpoints.

Install

Copy the command and run it in a terminal.

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

After installing, type/contract-cli-mdm-fieldsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project 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 当成数据查询命令
  • 不要假设它会自动帮你校验写请求

Comments

Markdown supported