contract-cli-mdm-legal

Original：🇺🇸 English
Translated

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

2installs
Sourceqfeius/contract-cli
Added on

NPX Install

npx skill4agent add qfeius/contract-cli contract-cli-mdm-legal

Tags

Translated version includes tags in frontmatter
contract-climdm-legalentity-querycli-toolcommand-line

SKILL.md Content

View Translation Comparison →

contract-cli MDM Legal

CRITICAL — 开始前 MUST 先读取 ../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
  • 用户想创建或更新法人实体：当前结构化命令未实现，不要伪造

关键规则

  • 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/entity-query-guide.md
  • references/entity-query-parameters.md
  • references/commands.md

操作建议

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

不要这样做

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