用途:该技能对应 contract-cli 的 MDM 交易方查询能力,供用户在使用 contract-cli mdm vendor list|get 查询合同域交易方数据时触发。
主要能力:支持两类命令——contract-cli mdm vendor list 列出交易方候选,contract-cli mdm vendor get <vendor-id> 按 ID 获取交易方详情。已知交易方 ID 时直接用 get;只知道名称或需要候选列表时用 list。
使用方式:开始前必须先读取 ../contract-cli-shared/SKILL.md。list 支持 --name、--page-size、--page-token。身份区分上,list --as user 走 /open-apis/contract/v1/mcp/vendors,list --as bot 走 /open-apis/mdm/v1/vendors;get --as user 走 /open-apis/contract/v1/mcp/vendors/{vendor_id},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 抄命令示例。
限制:创建或更新交易方当前结构化命令未实现,明确说明暂未覆盖,不要退回 api call。不要把 list/get 当成字段配置查询;确认字段定义应切到 ../contract-cli-mdm-fields/SKILL.md。创建合同前如只是要选对方主体,优先记住交易方 id。