# Contract CLI Mdm Legal

> contract-cli 法人实体查询技能：列出法人实体候选列表或按 ID 获取法人实体详情。当用户要使用 `contract-cli mdm legal list|get` 查询合同域法人实体数据时触发。

- Skill: `qfeius/contract-cli-mdm-legal` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add qfeius/contract-cli-mdm-legal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qfeius/contract-cli-mdm-legal/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: qfeius (https://skillmd.com/u/qfeius)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qfeius/contract-cli-mdm-legal

---


# contract-cli MDM Legal

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

## 适用命令

- `contract-cli mdm legal list`
- `contract-cli mdm legal get <legal-entity-id>`

## 快速决策

- 已知法人实体 ID：直接用 `mdm legal get`
- 只知道名称、需要候选列表：用 `mdm legal list`
- 用户是想查字段配置：切到 [../contract-cli-mdm-fields/SKILL.md](../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-guide.md) 选查询场景
  - 再读 [references/entity-query-parameters.md](references/entity-query-parameters.md) 查请求参数映射
  - 最后读 [references/commands.md](references/commands.md) 抄命令示例

## 实现来源

- [internal/cli/vendor_command.go](../../internal/cli/vendor_command.go)
- [internal/openplatform/entity/service.go](../../internal/openplatform/entity/service.go)
- [references/entity-query-guide.md](references/entity-query-guide.md)
- [references/entity-query-parameters.md](references/entity-query-parameters.md)
- [references/commands.md](references/commands.md)

## 操作建议

- 只知道主体名称时，先 `mdm legal list` 拿候选，再 `mdm legal get` 查详情
- 创建合同前如果只是要选我方主体，优先记住法人实体 id
- 想确认写接口字段定义时，切到 `mdm fields list`

## 不要这样做

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