github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
066094a68cd849e56f274f1ec2a3702eb8287c5e
dingtalk-workspace-cli/internal/cli/schema_catalog/tools/ding.json
T
玉澜 746b7e403c fix(schema): restore merge-base contract parity for the corecmd migration 
The ContractFinal assembly path dropped every non-declared parameter fact,
breaking the published Schema against the reviewed merge-base contract:

- merge pinned MCP parameter metadata and the reviewed in-code runtime hints
  back into contract_final parameter resolution (318 interface_type losses,
  calendar recurrence required/required_when regressions)
- restore devapp write risk to high and publish back to write/high; the
  migration silently downgraded 14 dev write tools and re-classified publish
  as destructive
- keep dev at-least-one checks as Validate hooks with the shipped wording
  instead of publishing new typed constraints; constraint publication is a
  contract change that belongs to its own reviewed PR (aitable annotations
  reverted for the same reason)
- align RunE escape hatch, BoolFlag shadowing, guard-first ConfirmFirst
  declaration, and Sheet target preflight with behavioral tests; drop the
  retired gen_schema_decls.py helper and fix corecmd naming in docs/CHANGELOG

check-authoritative-schema-compatibility vs origin/main: ok.
2026-07-31 22:15:45 +08:00

3638 lines
133 KiB
JSON
Raw Blame History

{
"product": "ding",
"tools": {
"ding.recall_ding_message": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "撤回已发送的机器人 DING",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要以用户身份撤回 DING 时不要使用本命令"
],
"canonical_path": "ding.recall_ding_message",
"cli_name": "recall",
"cli_path": "ding message recall",
"confirmation": "not_required",
"description": "撤回已发送的机器人 DING",
"display": "DING 消息 / 发送 / 撤回",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws ding message recall --robot-code \u003cROBOT_CODE\u003e --id \u003cOPEN_DING_ID\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回已发送的机器人 DING"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回已发送的机器人 DING"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要以用户身份撤回 DING 时不要使用本命令"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要以用户身份撤回 DING 时不要使用本命令"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.recall_ding_message"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.recall_ding_message"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回已发送的机器人 DING"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回已发送的机器人 DING"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding message recall --robot-code \u003cROBOT_CODE\u003e --id \u003cOPEN_DING_ID\u003e --format json"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding message recall --robot-code \u003cROBOT_CODE\u003e --id \u003cOPEN_DING_ID\u003e --format json"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "mcp"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "mcp"
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": {
"product_id": "ding",
"rpc_name": "recall_ding_message"
}
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": {
"product_id": "ding",
"rpc_name": "recall_ding_message"
}
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回 DING 消息"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回 DING 消息"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"已知 openDingId 与同一 robot-code，需要撤回机器人 DING"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"已知 openDingId 与同一 robot-code，需要撤回机器人 DING"
]
}
},
"group": "message",
"has_parameters": true,
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "ding",
"rpc_name": "recall_ding_message"
},
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "recall_ding_message",
"parameter_count": 2,
"parameters": {
"id": {
"description": "DING 消息 ID (必填)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "DING 消息 ID (必填)"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "要撤回的钉钉消息ID，可通过发送DING消息接口获取"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "DING 消息 ID (必填)"
},
"property": {
"candidates": [
{
"precedence": "versioned_binding",
"selected": true,
"source": "versioned_parameter_binding",
"value": "openDingId"
},
{
"precedence": "inference",
"selected": false,
"source": "flag_name_inference",
"value": "id"
}
],
"precedence": "versioned_binding",
"resolution": "highest_precedence",
"source": "versioned_parameter_binding",
"value": "openDingId"
},
"required": {
"candidates": [
{
"precedence": "mcp_metadata",
"selected": true,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "mcp_metadata",
"resolution": "highest_precedence",
"source": "mcp_metadata",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "要撤回的钉钉消息ID，可通过发送DING消息接口获取",
"property": "openDingId",
"required": true,
"type": "string"
},
"robot-code": {
"description": "机器人 ID (必填，或设 DINGTALK_DING_ROBOT_CODE)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "机器人 ID (必填，或设 DINGTALK_DING_ROBOT_CODE)"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "发送钉钉消息的机器人ID，必须与发送消息的机器人为同一个"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "机器人 ID (必填，或设 DINGTALK_DING_ROBOT_CODE)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "robotCode"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "robotCode"
},
"required": {
"candidates": [
{
"precedence": "mcp_metadata",
"selected": true,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "mcp_metadata",
"resolution": "highest_precedence",
"source": "mcp_metadata",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "发送钉钉消息的机器人ID，必须与发送消息的机器人为同一个",
"property": "robotCode",
"required": true,
"type": "string"
}
},
"path": "ding.recall_ding_message",
"primary_cli_path": "ding message recall",
"product_id": "ding",
"reviewed": true,
"risk": "medium",
"source": "reviewed_command_registry",
"title": "撤回 DING 消息",
"use_when": [
"已知 openDingId 与同一 robot-code，需要撤回机器人 DING"
]
},
"ding.send_ding_message": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "以企业机器人发送应用内/短信/电话 DING",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"普通聊天消息用 chat message send / send-by-bot",
"需要用户身份 DING 时不要用本命令（机器人身份）",
"短信/电话有成本，用户未确认前不要发 call/sms"
],
"canonical_path": "ding.send_ding_message",
"cli_name": "send",
"cli_path": "ding message send",
"confirmation": "not_required",
"description": "发送 DING 消息。类型:\n app = 应用内 DING (默认)\n sms = 短信 DING (有成本)\n call = 电话 DING (有成本)",
"display": "DING 消息 / 发送 / 撤回",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --users userId1,userId2 --content \"请查看\" --format json",
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --type call --users userId1 --content \"紧急告警\" --format json"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以企业机器人发送应用内/短信/电话 DING"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以企业机器人发送应用内/短信/电话 DING"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"普通聊天消息用 chat message send / send-by-bot",
"需要用户身份 DING 时不要用本命令（机器人身份）",
"短信/电话有成本，用户未确认前不要发 call/sms"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"普通聊天消息用 chat message send / send-by-bot",
"需要用户身份 DING 时不要用本命令（机器人身份）",
"短信/电话有成本，用户未确认前不要发 call/sms"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.send_ding_message"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.send_ding_message"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "发送 DING 消息。类型:\n app = 应用内 DING (默认)\n sms = 短信 DING (有成本)\n call = 电话 DING (有成本)"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "发送 DING 消息。类型:\n app = 应用内 DING (默认)\n sms = 短信 DING (有成本)\n call = 电话 DING (有成本)"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --users userId1,userId2 --content \"请查看\" --format json",
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --type call --users userId1 --content \"紧急告警\" --format json"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --users userId1,userId2 --content \"请查看\" --format json",
"dws ding message send --robot-code \u003cROBOT_CODE\u003e --type call --users userId1 --content \"紧急告警\" --format json"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "mcp"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "mcp"
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": {
"product_id": "ding",
"rpc_name": "send_ding_message"
}
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": {
"product_id": "ding",
"rpc_name": "send_ding_message"
}
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "发送 DING 消息"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "发送 DING 消息"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要用企业机器人向指定 userId 发送应用内、短信或电话 DING"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要用企业机器人向指定 userId 发送应用内、短信或电话 DING"
]
}
},
"group": "message",
"has_parameters": true,
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "ding",
"rpc_name": "send_ding_message"
},
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "send_ding_message",
"parameter_count": 4,
"parameters": {
"content": {
"description": "消息内容 (必填)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "消息内容 (必填)"
},
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "DING 消息内容。"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "消息内容"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "消息内容 (必填)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "content"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "content"
},
"required": {
"candidates": [
{
"precedence": "tool_schema_hint",
"selected": true,
"source": "tool_schema_hint",
"value": true
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "tool_schema_hint",
"resolution": "highest_precedence",
"source": "tool_schema_hint",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "消息内容",
"property": "content",
"required": true,
"type": "string"
},
"robot-code": {
"description": "机器人 ID，发 DING 的机器人编码 (必填，可从 应用管理→机器人 获取，或设 DINGTALK_DING_ROBOT_CODE)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "机器人 ID，发 DING 的机器人编码 (必填，可从 应用管理→机器人 获取，或设 DINGTALK_DING_ROBOT_CODE)"
},
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "DING 机器人编码。通常来自开放平台或应用机器人配置。"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "机器人Code"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "机器人 ID，发 DING 的机器人编码 (必填，可从 应用管理→机器人 获取，或设 DINGTALK_DING_ROBOT_CODE)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "robotCode"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "robotCode"
},
"required": {
"candidates": [
{
"precedence": "tool_schema_hint",
"selected": true,
"source": "tool_schema_hint",
"value": true
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "tool_schema_hint",
"resolution": "highest_precedence",
"source": "tool_schema_hint",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "机器人Code",
"property": "robotCode",
"required": true,
"type": "string"
},
"type": {
"default": "app",
"description": "提醒类型: app/sms/call (默认 app)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "提醒类型: app/sms/call (默认 app)"
},
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "提醒类型。CLI 默认使用 app，对应应用内提醒。"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "提醒类型，1：应用内钉钉，2：短信，3：电话"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "提醒类型: app/sms/call (默认 app)"
},
"interface_type": {
"candidates": [
{
"precedence": "mcp_metadata",
"selected": true,
"source": "mcp_metadata",
"value": "number"
},
{
"precedence": "fallback",
"selected": false,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "mcp_metadata",
"resolution": "highest_precedence",
"source": "mcp_metadata",
"value": "number"
},
"property": {
"candidates": [
{
"precedence": "versioned_binding",
"selected": true,
"source": "versioned_parameter_binding",
"value": "remindType"
},
{
"precedence": "inference",
"selected": false,
"source": "flag_name_inference",
"value": "type"
}
],
"precedence": "versioned_binding",
"resolution": "highest_precedence",
"source": "versioned_parameter_binding",
"value": "remindType"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "提醒类型，1：应用内钉钉，2：短信，3：电话",
"interface_type": "number",
"property": "remindType",
"required": false,
"type": "string"
},
"users": {
"description": "接收人 userId 列表 (必填)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "接收人 userId 列表 (必填)"
},
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "接收人的 userId 列表。CLI 使用逗号分隔，例如 user1,user2。"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "接收者用户ID列表"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "接收人 userId 列表 (必填)"
},
"interface_type": {
"candidates": [
{
"precedence": "tool_schema_hint",
"selected": true,
"source": "tool_schema_hint",
"value": "array"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": "array"
},
{
"precedence": "fallback",
"selected": false,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "tool_schema_hint",
"resolution": "highest_precedence",
"source": "tool_schema_hint",
"value": "array"
},
"property": {
"candidates": [
{
"precedence": "versioned_binding",
"selected": true,
"source": "versioned_parameter_binding",
"value": "receiverUserIdList"
},
{
"precedence": "inference",
"selected": false,
"source": "flag_name_inference",
"value": "users"
}
],
"precedence": "versioned_binding",
"resolution": "highest_precedence",
"source": "versioned_parameter_binding",
"value": "receiverUserIdList"
},
"required": {
"candidates": [
{
"precedence": "tool_schema_hint",
"selected": true,
"source": "tool_schema_hint",
"value": true
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "tool_schema_hint",
"resolution": "highest_precedence",
"source": "tool_schema_hint",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"interface_description": "接收者用户ID列表",
"interface_type": "array",
"property": "receiverUserIdList",
"required": true,
"type": "string"
}
},
"path": "ding.send_ding_message",
"primary_cli_path": "ding message send",
"product_id": "ding",
"reviewed": true,
"risk": "medium",
"source": "reviewed_command_registry",
"title": "发送 DING 消息",
"use_when": [
"需要用企业机器人向指定 userId 发送应用内、短信或电话 DING"
]
},
"ding.shortcut_list": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "查询 DING 消息列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"canonical_path": "ding.shortcut_list",
"cli_name": "+list",
"cli_path": "ding +list",
"confirmation": "not_required",
"description": "当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。",
"display": "DING 消息 / 发送 / 撤回",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws ding +list"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息列表"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息列表"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_list"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_list"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "read"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "read"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +list"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +list"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "idempotent"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "idempotent"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
},
"interface_reason": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "low"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "low"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息列表"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息列表"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
]
}
},
"has_parameters": true,
"idempotency": "idempotent",
"interface_mode": "composite",
"interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "shortcut_list",
"parameter_count": 2,
"parameters": {
"cursor": {
"description": "分页游标 (可选)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "分页游标 (可选)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "分页游标 (可选)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "cursor"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "cursor"
},
"required": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": false
}
],
"precedence": "default",
"resolution": "fallback",
"source": "default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "integer"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "integer"
}
},
"property": "cursor",
"required": false,
"type": "integer"
},
"type": {
"default": "ALL",
"description": "类型 (可选，默认 ALL)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "类型 (可选，默认 ALL)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "类型 (可选，默认 ALL)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "type"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "type"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "type",
"required": false,
"type": "string"
}
},
"path": "ding.shortcut_list",
"primary_cli_path": "ding +list",
"product_id": "ding",
"reviewed": true,
"risk": "low",
"source": "reviewed_command_registry",
"title": "查询 DING 消息列表",
"use_when": [
"当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
]
},
"ding.shortcut_recall_personal": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "撤回本人发起的 DING",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"canonical_path": "ding.shortcut_recall_personal",
"cli_name": "+recall-personal",
"cli_path": "ding +recall-personal",
"confirmation": "user_required",
"description": "当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。",
"display": "DING 消息 / 发送 / 撤回",
"effect": "destructive",
"effect_source": "corecmd.contract",
"examples": [
"dws ding +recall-personal --id \u003cID\u003e"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回本人发起的 DING"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回本人发起的 DING"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_recall_personal"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_recall_personal"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "user_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "user_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "destructive"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "destructive"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +recall-personal --id \u003cID\u003e"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +recall-personal --id \u003cID\u003e"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
},
"interface_reason": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "high"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "high"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回本人发起的 DING"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "撤回本人发起的 DING"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
]
}
},
"has_parameters": true,
"idempotency": "unknown",
"interface_mode": "composite",
"interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "shortcut_recall_personal",
"parameter_count": 1,
"parameters": {
"id": {
"description": "openDingId（必填）",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "openDingId（必填）"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "openDingId（必填）"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "id"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "id"
},
"required": {
"candidates": [
{
"precedence": "native_annotation",
"selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "native_annotation",
"resolution": "highest_precedence",
"source": "native_annotation",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "id",
"required": true,
"type": "string"
}
},
"path": "ding.shortcut_recall_personal",
"primary_cli_path": "ding +recall-personal",
"product_id": "ding",
"reviewed": true,
"risk": "high",
"source": "reviewed_command_registry",
"title": "撤回本人发起的 DING",
"use_when": [
"当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
]
},
"ding.shortcut_receiver_status": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "查询 DING 消息接收人已读状态",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"canonical_path": "ding.shortcut_receiver_status",
"cli_name": "+receiver-status",
"cli_path": "ding +receiver-status",
"confirmation": "not_required",
"description": "当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。",
"display": "DING 消息 / 发送 / 撤回",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws ding +receiver-status --ding-id \u003cDING_ID\u003e"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息接收人已读状态"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息接收人已读状态"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_receiver_status"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_receiver_status"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "read"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "read"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +receiver-status --ding-id \u003cDING_ID\u003e"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +receiver-status --ding-id \u003cDING_ID\u003e"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "idempotent"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "idempotent"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
},
"interface_reason": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "low"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "low"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息接收人已读状态"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "查询 DING 消息接收人已读状态"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
]
}
},
"has_parameters": true,
"idempotency": "idempotent",
"interface_mode": "composite",
"interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "shortcut_receiver_status",
"parameter_count": 1,
"parameters": {
"ding-id": {
"description": "openDingId（必填）",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "openDingId（必填）"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "openDingId（必填）"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "dingId"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "dingId"
},
"required": {
"candidates": [
{
"precedence": "native_annotation",
"selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "native_annotation",
"resolution": "highest_precedence",
"source": "native_annotation",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "dingId",
"required": true,
"type": "string"
}
},
"path": "ding.shortcut_receiver_status",
"primary_cli_path": "ding +receiver-status",
"product_id": "ding",
"reviewed": true,
"risk": "low",
"source": "reviewed_command_registry",
"title": "查询 DING 消息接收人已读状态",
"use_when": [
"当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
]
},
"ding.shortcut_send_personal": {
"agent_metadata_source": "corecmd.contract",
"agent_source_refs": [
"corecmd.SchemaDecl"
],
"agent_summary": "以本人身份发送 DING 给指定人",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"canonical_path": "ding.shortcut_send_personal",
"cli_name": "+send-personal",
"cli_path": "ding +send-personal",
"confirmation": "user_required",
"description": "当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。",
"display": "DING 消息 / 发送 / 撤回",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws ding +send-personal --users \u003cVALUES\u003e --content \u003cCONTENT\u003e"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以本人身份发送 DING 给指定人"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以本人身份发送 DING 给指定人"
},
"availability": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_send_personal"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "ding.shortcut_send_personal"
},
"confirmation": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "user_required"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "user_required"
},
"description": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
},
"effect": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "write"
},
"examples": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +send-personal --users \u003cVALUES\u003e --content \u003cCONTENT\u003e"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"dws ding +send-personal --users \u003cVALUES\u003e --content \u003cCONTENT\u003e"
]
},
"idempotency": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "unknown"
},
"interface_mode": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "composite"
},
"interface_reason": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref."
},
"interface_ref": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": null
},
"metadata_source": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "corecmd.contract"
},
"reviewed": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "medium"
},
"title": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以本人身份发送 DING 给指定人"
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": "以本人身份发送 DING 给指定人"
},
"use_when": {
"candidates": [
{
"precedence": "contract_final",
"review_reason": "Contract final Schema pass-through",
"selected": true,
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
]
}
],
"precedence": "contract_final",
"resolution": "contract_pass_through",
"review_reason": "Contract final Schema pass-through",
"source": "corecmd.contract",
"source_ref": "corecmd.SchemaDecl",
"value": [
"当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
]
}
},
"has_parameters": true,
"idempotency": "unknown",
"interface_mode": "composite",
"interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
"is_alias": false,
"metadata_source": "corecmd.contract",
"name": "shortcut_send_personal",
"parameter_count": 4,
"parameters": {
"content": {
"description": "消息内容（必填）",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "消息内容（必填）"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "消息内容（必填）"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "content"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "content"
},
"required": {
"candidates": [
{
"precedence": "native_annotation",
"selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "native_annotation",
"resolution": "highest_precedence",
"source": "native_annotation",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "content",
"required": true,
"type": "string"
},
"type": {
"default": "app",
"description": "提醒方式 remindType",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "提醒方式 remindType"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "提醒方式 remindType"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "type"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "type"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "type",
"required": false,
"type": "string"
},
"users": {
"description": "接收人 openDingTalkId 列表 (CSV)（必填）",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "接收人 openDingTalkId 列表 (CSV)（必填）"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "接收人 openDingTalkId 列表 (CSV)（必填）"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "users"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "users"
},
"required": {
"candidates": [
{
"precedence": "native_annotation",
"selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "inference",
"selected": false,
"source": "usage_required_inference",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "native_annotation",
"resolution": "highest_precedence",
"source": "native_annotation",
"value": true
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "array"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "array"
}
},
"property": "users",
"required": true,
"type": "array"
},
"uuid": {
"description": "幂等键 (可选)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "幂等键 (可选)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "幂等键 (可选)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "uuid"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "uuid"
},
"required": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": false
}
],
"precedence": "default",
"resolution": "fallback",
"source": "default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "uuid",
"required": false,
"type": "string"
}
},
"path": "ding.shortcut_send_personal",
"primary_cli_path": "ding +send-personal",
"product_id": "ding",
"reviewed": true,
"risk": "medium",
"source": "reviewed_command_registry",
"title": "以本人身份发送 DING 给指定人",
"use_when": [
"当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink