用途:查询合同域法人实体数据。开始前必须先读取 ../contract-cli-shared/SKILL.md。
主要能力:使用 contract-cli mdm legal list 列出候选法人实体,使用 contract-cli mdm legal get <legal-entity-id> 按 ID 获取详情。快速决策:已知 ID 直接用 mdm legal get;只有名称、需要候选列表用 mdm legal list;查字段配置切到 ../contract-cli-mdm-fields/SKILL.md;创建或更新法人实体当前结构化命令未实现,不要伪造。
关键规则:mdm legal list 支持 --name、--page-size、--page-token;mdm legal list --as user 走 /open-apis/contract/v1/mcp/legal_entities;mdm legal list --as bot 走 /open-apis/mdm/v1/legal_entities/list_all;mdm legal get --as user 走 /open-apis/contract/v1/mcp/legal_entities/{legal_entity_id};mdm legal get --as bot 走 /open-apis/mdm/v1/legal_entities/{legal_entity_id},并额外透传 query legal_entity_id;不暴露 --operator;--user-id-type / --user-id 仍按共享规则透传,不做本地校验。
推荐阅读顺序:先读 references/entity-query-guide.md 选查询场景,再读 references/entity-query-parameters.md 查请求参数映射,最后读 references/commands.md 抄命令示例。
实现来源:internal/cli/vendor_command.go、internal/openplatform/entity/service.go 及上述 references 文档。
操作建议:只知道主体名称时,先 mdm legal list 拿候选,再 mdm legal get 查详情;创建合同前若只是要选我方主体,优先记住法人实体 id;想确认写接口字段定义时切到 mdm fields list。
限制:不要把 mdm legal list/get 当成字段配置查询;不要把未实现的 mdm legal create/update 当成已有结构化命令。