contract-cli-mdm-vendor

name: contract-cli-mdm-vendor version: 1.0.0 description: "contract-cli 交易方查询技能：列出交易方候选列表或按 ID 获取交易方详情。当用户要使用 contract-cli mdm vendor list|get 查询合同域交易方数据时触发。"

contract-cli MDM Vendor

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

适用命令

• contract-cli mdm vendor list
• contract-cli mdm vendor get <vendor-id>

快速决策

• 已知交易方 ID：直接用 mdm vendor get
• 只知道名称或想拿候选列表：用 mdm vendor list
• 如果用户想在创建前确认字段定义：切到 ../contract-cli-mdm-fields/SKILL.md
• 如果用户想创建或更新交易方：当前结构化命令未实现，明确说明暂未覆盖；不要退回 api call

关键规则

• mdm vendor list 支持 --name、--page-size、--page-token
• mdm vendor list --as user 走 /open-apis/contract/v1/mcp/vendors
• mdm vendor list --as bot 走 /open-apis/mdm/v1/vendors
• mdm vendor get --as user 走 /open-apis/contract/v1/mcp/vendors/{vendor_id}
• mdm vendor get --as bot 走 /open-apis/mdm/v1/vendors/{vendor_id}
• 不暴露 --operator
• --user-id-type / --user-id 仍按共享规则透传，不做本地校验
• 推荐阅读顺序是：
  • 先读 references/vendor-query-guide.md 选查询场景
  • 再读 references/vendor-query-parameters.md 查请求参数映射
  • 最后读 references/commands.md 抄命令示例

实现来源

• internal/cli/vendor_command.go
• internal/openplatform/mdmvendor/service.go
• references/vendor-query-guide.md
• references/vendor-query-parameters.md
• references/commands.md

操作建议

• 只知道名称时，先 mdm vendor list 拿候选，再 mdm vendor get 查详情
• 创建合同前如果只是要选对方主体，优先记住交易方 id
• 想确认写接口字段定义时，切到 mdm fields list

不要这样做

• 不要把 mdm vendor list/get 当成字段配置查询
• 不要把未实现的 mdm vendor create/update 当成已有结构化命令