dingtalk-workspace-cli/internal/cli/schema_agent_metadata/doc.json

{
  "product_id": "doc",
  "tools": {
    "doc block delete": {
      "agent_summary": "删除块元素（不可逆）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "块 ID 或不可逆删除意图未确认时不要使用；仅修改内容应改用块更新命令。"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "skill-explicit",
      "examples": [
        "dws doc block delete --node DOC_ID --block-id BLOCK_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "删除块元素（不可逆）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "删除块元素（不可逆）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "块 ID 或不可逆删除意图未确认时不要使用；仅修改内容应改用块更新命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "块 ID 或不可逆删除意图未确认时不要使用；仅修改内容应改用块更新命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "destructive",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block delete --node DOC_ID --block-id BLOCK_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc block delete --node DOC_ID --block-id BLOCK_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.delete_document_block",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.delete_document_block",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.delete_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "high",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "用户明确要求删除块元素（不可逆）时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "用户明确要求删除块元素（不可逆）时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "delete_document_block"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.delete_document_block",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc block delete",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.delete_document_block",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.delete_document_block",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document_block"
      ],
      "use_when": [
        "用户明确要求删除块元素（不可逆）时"
      ]
    },
    "doc block insert": {
      "agent_summary": "向文档插入块元素",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要修改已有块或尚未确认插入位置与块类型时不要使用；已有块应调用更新命令。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc block insert --node DOC_ID --text \"这是一段文字\" --format json",
        "dws doc block insert --node DOC_ID --heading \"二级标题\" --level 2 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "向文档插入块元素",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "向文档插入块元素",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要修改已有块或尚未确认插入位置与块类型时不要使用；已有块应调用更新命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要修改已有块或尚未确认插入位置与块类型时不要使用；已有块应调用更新命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block insert --node DOC_ID --text \"这是一段文字\" --format json",
            "dws doc block insert --node DOC_ID --heading \"二级标题\" --level 2 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc block insert --node DOC_ID --text \"这是一段文字\" --format json",
                "dws doc block insert --node DOC_ID --heading \"二级标题\" --level 2 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.insert_document_block",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.insert_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要向文档插入块元素时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要向文档插入块元素时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "insert_document_block"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.insert_document_block",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc block insert",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.insert_document_block"
      ],
      "use_when": [
        "需要向文档插入块元素时"
      ]
    },
    "doc block list": {
      "agent_summary": "查询文档一级块元素列表",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要新增、修改或删除文档块时不要使用；该命令只列出一级块。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc block list --node DOC_ID --format json",
        "dws doc block list --node DOC_ID --start-index 0 --end-index 5 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档一级块元素列表",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "查询文档一级块元素列表",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要新增、修改或删除文档块时不要使用；该命令只列出一级块。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要新增、修改或删除文档块时不要使用；该命令只列出一级块。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block list --node DOC_ID --format json",
            "dws doc block list --node DOC_ID --start-index 0 --end-index 5 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc block list --node DOC_ID --format json",
                "dws doc block list --node DOC_ID --start-index 0 --end-index 5 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_document_blocks",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_document_blocks",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.list_document_blocks",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要查询文档一级块元素列表时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要查询文档一级块元素列表时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_document_blocks"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_document_blocks",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc block list",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_document_blocks",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_document_blocks",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_document_blocks"
      ],
      "use_when": [
        "需要查询文档一级块元素列表时"
      ]
    },
    "doc block update": {
      "agent_summary": "更新文档中的指定块",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "目标块 ID 或新内容未确认时不要修改；需要新增块应使用块插入命令。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc block update --node DOC_ID --block-id BLOCK_ID --text \"新内容\" --format json",
        "dws doc block update --node DOC_ID --block-id BLOCK_ID --element '{\"blockType\":\"heading\",\"heading\":{\"text\":\"新标题\",\"level\":1}}' --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新文档中的指定块",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "更新文档中的指定块",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "目标块 ID 或新内容未确认时不要修改；需要新增块应使用块插入命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "目标块 ID 或新内容未确认时不要修改；需要新增块应使用块插入命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block update --node DOC_ID --block-id BLOCK_ID --text \"新内容\" --format json",
            "dws doc block update --node DOC_ID --block-id BLOCK_ID --element '{\"blockType\":\"heading\",\"heading\":{\"text\":\"新标题\",\"level\":1}}' --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc block update --node DOC_ID --block-id BLOCK_ID --text \"新内容\" --format json",
                "dws doc block update --node DOC_ID --block-id BLOCK_ID --element '{\"blockType\":\"heading\",\"heading\":{\"text\":\"新标题\",\"level\":1}}' --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_document_block",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要更新文档中的指定块时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要更新文档中的指定块时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_document_block"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_document_block",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc block update",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document_block"
      ],
      "use_when": [
        "需要更新文档中的指定块时"
      ]
    },
    "doc comment create": {
      "agent_summary": "创建文档评论",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需读取评论或回复已有评论时不要新建顶层评论；应分别使用评论列表或回复命令。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc comment create --node DOC_ID --content \"这里需要修改\" --format json",
        "dws doc comment create --node DOC_ID --content \"请review\" --mention uid1,uid2 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文档评论",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "创建文档评论",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需读取评论或回复已有评论时不要新建顶层评论；应分别使用评论列表或回复命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需读取评论或回复已有评论时不要新建顶层评论；应分别使用评论列表或回复命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment create --node DOC_ID --content \"这里需要修改\" --format json",
            "dws doc comment create --node DOC_ID --content \"请review\" --mention uid1,uid2 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc comment create --node DOC_ID --content \"这里需要修改\" --format json",
                "dws doc comment create --node DOC_ID --content \"请review\" --mention uid1,uid2 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.create_comment",
          "source": "internal/cli/schema_hints/interface-refs.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source",
          "candidates": [
            {
              "value": "doc-comment.create_comment",
              "source": "internal/cli/schema_hints/interface-refs.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source"
            },
            {
              "value": "doc.create_comment",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.create_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要创建文档评论时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要创建文档评论时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "create_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_comment",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc comment create",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/interface-refs.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_comment",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_comment"
      ],
      "use_when": [
        "需要创建文档评论时"
      ]
    },
    "doc comment create-inline": {
      "agent_summary": "在文档选中文本范围创建划词评论",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "没有明确文本块和选区范围时不要创建划词评论；普通文档评论应使用非划词评论命令。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 0 --end 10 --content \"这里需要修改\" --format json",
        "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 5 --end 20 --content \"建议调整\" --selected-text \"被选中的原文\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "在文档选中文本范围创建划词评论",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "在文档选中文本范围创建划词评论",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "没有明确文本块和选区范围时不要创建划词评论；普通文档评论应使用非划词评论命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "没有明确文本块和选区范围时不要创建划词评论；普通文档评论应使用非划词评论命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 0 --end 10 --content \"这里需要修改\" --format json",
            "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 5 --end 20 --content \"建议调整\" --selected-text \"被选中的原文\" --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 0 --end 10 --content \"这里需要修改\" --format json",
                "dws doc comment create-inline --node DOC_ID --block-id BLOCK_ID --start 5 --end 20 --content \"建议调整\" --selected-text \"被选中的原文\" --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.create_inline_comment",
          "source": "internal/cli/schema_hints/interface-refs.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source",
          "candidates": [
            {
              "value": "doc-comment.create_inline_comment",
              "source": "internal/cli/schema_hints/interface-refs.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source"
            },
            {
              "value": "doc-comment.create_inline_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要在文档选中文本范围创建划词评论时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要在文档选中文本范围创建划词评论时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "create_inline_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_inline_comment",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc comment create-inline",
        "internal/cli/schema_hints/interface-refs.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_inline_comment"
      ],
      "use_when": [
        "需要在文档选中文本范围创建划词评论时"
      ]
    },
    "doc comment delete": {
      "agent_summary": "永久删除指定文档中的一条评论。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
      "availability": "available",
      "avoid_when": [
        "只需修改或回复评论、目标评论不明确，或用户尚未确认永久删除时不要使用。"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc comment delete --node DOC_ID --comment-key COMMENT_KEY"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "永久删除指定文档中的一条评论。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。",
          "candidates": [
            {
              "value": "永久删除指定文档中的一条评论。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需修改或回复评论、目标评论不明确，或用户尚未确认永久删除时不要使用。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。",
          "candidates": [
            {
              "value": [
                "只需修改或回复评论、目标评论不明确，或用户尚未确认永久删除时不要使用。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "user_required",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "destructive",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "destructive",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment delete --node DOC_ID --comment-key COMMENT_KEY"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。",
          "candidates": [
            {
              "value": [
                "dws doc comment delete --node DOC_ID --comment-key COMMENT_KEY"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "interface_reason": {
          "value": "The reviewed CLI wrapper is executable, but doc-comment/delete_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "The reviewed CLI wrapper is executable, but doc-comment/delete_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "high",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "high",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            }
          ]
        },
        "use_when": {
          "value": [
            "用户明确要求永久删除已知文档中的指定评论时。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。",
          "candidates": [
            {
              "value": [
                "用户明确要求永久删除已知文档中的指定评论时。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、不可恢复的运行时确认语义和 doc comment 参考补齐 reviewed Agent 选择语义；示例不绕过用户确认。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "The reviewed CLI wrapper is executable, but doc-comment/delete_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "cobra-help:dws doc comment delete --help",
        "internal/cli/schema_command_registry.json#doc.delete_comment",
        "internal/cli/schema_hints/zz-interface-disposition-review.json",
        "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
        "internal/cli/schema_manual_hints.json",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "用户明确要求永久删除已知文档中的指定评论时。"
      ]
    },
    "doc comment list": {
      "agent_summary": "查询文档评论列表",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要新建、回复或删除评论时不要使用；该命令只读取评论列表。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc comment list --node DOC_ID --format json",
        "dws doc comment list --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --limit 20 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档评论列表",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "查询文档评论列表",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要新建、回复或删除评论时不要使用；该命令只读取评论列表。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要新建、回复或删除评论时不要使用；该命令只读取评论列表。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment list --node DOC_ID --format json",
            "dws doc comment list --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --limit 20 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc comment list --node DOC_ID --format json",
                "dws doc comment list --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --limit 20 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.list_comments",
          "source": "internal/cli/schema_hints/interface-refs.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source",
          "candidates": [
            {
              "value": "doc-comment.list_comments",
              "source": "internal/cli/schema_hints/interface-refs.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source"
            },
            {
              "value": "doc.list_comments",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.list_comments",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要查询文档评论列表时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要查询文档评论列表时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "list_comments"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_comments",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc comment list",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_comments",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/interface-refs.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_comments",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_comments"
      ],
      "use_when": [
        "需要查询文档评论列表时"
      ]
    },
    "doc comment reply": {
      "agent_summary": "回复文档评论",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "没有明确父评论时不要使用；需要创建顶层评论应改用评论创建命令。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\" --format json",
        "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"比心\" --emoji --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "回复文档评论",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "回复文档评论",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "没有明确父评论时不要使用；需要创建顶层评论应改用评论创建命令。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "没有明确父评论时不要使用；需要创建顶层评论应改用评论创建命令。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\" --format json",
            "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"比心\" --emoji --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\" --format json",
                "dws doc comment reply --node DOC_ID --comment-key COMMENT_KEY --content \"比心\" --emoji --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.reply_comment",
          "source": "internal/cli/schema_hints/interface-refs.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source",
          "candidates": [
            {
              "value": "doc-comment.reply_comment",
              "source": "internal/cli/schema_hints/interface-refs.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "open-source-helper-interface-refs is an explicit Agent hint source"
            },
            {
              "value": "doc.reply_comment",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.reply_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要回复文档评论时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要回复文档评论时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "reply_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.reply_comment",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc comment reply",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/interface-refs.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.reply_comment",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.reply_comment"
      ],
      "use_when": [
        "需要回复文档评论时"
      ]
    },
    "doc comment update": {
      "agent_summary": "更新指定文档评论的文字内容和可选 @提及用户。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
      "availability": "available",
      "avoid_when": [
        "需要新建、回复或删除评论时不要使用；没有 commentKey 时应先查询评论。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc comment update --node DOC_ID --comment-key COMMENT_KEY --content \"已按最新数据修正\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新指定文档评论的文字内容和可选 @提及用户。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。",
          "candidates": [
            {
              "value": "更新指定文档评论的文字内容和可选 @提及用户。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要新建、回复或删除评论时不要使用；没有 commentKey 时应先查询评论。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。",
          "candidates": [
            {
              "value": [
                "需要新建、回复或删除评论时不要使用；没有 commentKey 时应先查询评论。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment update --node DOC_ID --comment-key COMMENT_KEY --content \"已按最新数据修正\""
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。",
          "candidates": [
            {
              "value": [
                "dws doc comment update --node DOC_ID --comment-key COMMENT_KEY --content \"已按最新数据修正\""
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "interface_reason": {
          "value": "The reviewed CLI wrapper is executable, but doc-comment/update_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "The reviewed CLI wrapper is executable, but doc-comment/update_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/zz-interface-disposition-review.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "unverified-direct-interface-review-v1 marks this tool as reviewed"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要修改一条已知文档评论的正文或提及对象时。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。",
          "candidates": [
            {
              "value": [
                "需要修改一条已知文档评论的正文或提及对象时。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v2",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据新增的真实 Cobra leaf、评论更新参数和 doc comment 参考补齐 reviewed Agent 选择语义与示例。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "The reviewed CLI wrapper is executable, but doc-comment/update_comment is absent from the pinned MCP metadata snapshot; do not advertise a direct MCP interface.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "cobra-help:dws doc comment update --help",
        "internal/cli/schema_command_registry.json#doc.update_comment",
        "internal/cli/schema_hints/zz-interface-disposition-review.json",
        "internal/cli/schema_manual_hints.json",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "需要修改一条已知文档评论的正文或提及对象时。"
      ]
    },
    "doc copy": {
      "agent_summary": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规复制文档或文件时使用 dws drive copy；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc copy --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
        "dws doc copy --node DOC_ID --workspace TARGET_WS_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规复制文档或文件时使用 dws drive copy；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规复制文档或文件时使用 dws drive copy；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc copy --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
            "dws doc copy --node DOC_ID --workspace TARGET_WS_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc copy --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
                "dws doc copy --node DOC_ID --workspace TARGET_WS_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.copy_document",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.copy_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc copy 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc copy 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "copy_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.copy_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc copy",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.copy_document"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc copy 兼容入口时"
      ]
    },
    "doc create": {
      "agent_summary": "创建一篇新的在线文档",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需在知识库创建空节点或非文档类型时使用 wiki node create；已有文档内容应使用 doc update"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc create --name \"项目周报\" --format json",
        "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder DOC_FOLDER_NODE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建一篇新的在线文档",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "创建一篇新的在线文档",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需在知识库创建空节点或非文档类型时使用 wiki node create；已有文档内容应使用 doc update"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需在知识库创建空节点或非文档类型时使用 wiki node create；已有文档内容应使用 doc update"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc create --name \"项目周报\" --format json",
            "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder DOC_FOLDER_NODE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc create --name \"项目周报\" --format json",
                "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder DOC_FOLDER_NODE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_document",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_document",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.create_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要创建一篇新的在线文档时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要创建一篇新的在线文档时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc create",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_document",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_document",
        "skills/mono/references/intent-guide.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-create.md",
        "skills/mono/references/products/doc/doc-media.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_document",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_document"
      ],
      "use_when": [
        "需要创建一篇新的在线文档时"
      ]
    },
    "doc delete": {
      "agent_summary": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规将文件移入回收站时使用 dws drive delete；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "skill-explicit",
      "examples": [
        "dws doc delete --node DOC_ID --format json",
        "dws doc delete --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规将文件移入回收站时使用 dws drive delete；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规将文件移入回收站时使用 dws drive delete；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "destructive",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc delete --node DOC_ID --format json",
            "dws doc delete --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc delete --node DOC_ID --format json",
                "dws doc delete --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.delete_document",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.delete_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc delete 兼容入口，并已确认删除目标时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc delete 兼容入口，并已确认删除目标时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "delete_document"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.delete_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc delete",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc delete 兼容入口，并已确认删除目标时"
      ]
    },
    "doc download": {
      "agent_summary": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规下载钉盘或文档空间已有文件时使用 dws drive download；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc download --node NODE_ID --output ./downloads/ --format json",
        "dws doc download --node NODE_ID --output ./report.pdf --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规下载钉盘或文档空间已有文件时使用 dws drive download；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规下载钉盘或文档空间已有文件时使用 dws drive download；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc download --node NODE_ID --output ./downloads/ --format json",
            "dws doc download --node NODE_ID --output ./report.pdf --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc download --node NODE_ID --output ./downloads/ --format json",
                "dws doc download --node NODE_ID --output ./report.pdf --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.download_file",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.download_file",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc download 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc download 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "download_file"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.download_file",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc download",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.download_file",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "skills/mono/references/products/sheet.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_file"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc download 兼容入口时"
      ]
    },
    "doc export get": {
      "agent_summary": "查询文档导出任务结果",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "尚未提交导出任务或需要创建新的导出任务时不要使用；该命令只查询已有 jobId。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档导出任务结果",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "查询文档导出任务结果",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "尚未提交导出任务或需要创建新的导出任务时不要使用；该命令只查询已有 jobId。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "尚未提交导出任务或需要创建新的导出任务时不要使用；该命令只查询已有 jobId。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.query_export_job",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.query_export_job",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "已有导出 jobId，需要查询任务状态或下载结果时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "已有导出 jobId，需要查询任务状态或下载结果时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "query_export_job"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.query_export_job",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc export get",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-export.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.query_export_job"
      ],
      "use_when": [
        "已有导出 jobId，需要查询任务状态或下载结果时"
      ]
    },
    "doc file create": {
      "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规创建不要选择该兼容入口：知识库节点优先使用 dws wiki node create，钉盘文件夹使用 dws drive mkdir。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc file create --name \"项目周报\" --type adoc --format json",
        "dws doc file create --name \"数据统计\" --type axls --folder DOC_FOLDER_NODE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规创建不要选择该兼容入口：知识库节点优先使用 dws wiki node create，钉盘文件夹使用 dws drive mkdir。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规创建不要选择该兼容入口：知识库节点优先使用 dws wiki node create，钉盘文件夹使用 dws drive mkdir。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc file create --name \"项目周报\" --type adoc --format json",
            "dws doc file create --name \"数据统计\" --type axls --folder DOC_FOLDER_NODE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc file create --name \"项目周报\" --type adoc --format json",
                "dws doc file create --name \"数据统计\" --type axls --folder DOC_FOLDER_NODE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_file",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_file",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.create_file",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc file create 兼容入口创建节点时。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc file create 兼容入口创建节点时。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_file"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_file",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc file create",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_file",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_file",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_file",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_file"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc file create 兼容入口创建节点时。"
      ]
    },
    "doc folder create": {
      "agent_summary": "创建文件夹",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规创建文件夹不要选择该兼容入口：钉盘使用 dws drive mkdir，知识库使用 dws wiki node create。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc folder create --name \"项目资料\" --format json",
        "dws doc folder create --name \"子文件夹\" --folder PARENT_DOC_FOLDER_NODE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文件夹",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "创建文件夹",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规创建文件夹不要选择该兼容入口：钉盘使用 dws drive mkdir，知识库使用 dws wiki node create。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规创建文件夹不要选择该兼容入口：钉盘使用 dws drive mkdir，知识库使用 dws wiki node create。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc folder create --name \"项目资料\" --format json",
            "dws doc folder create --name \"子文件夹\" --folder PARENT_DOC_FOLDER_NODE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc folder create --name \"项目资料\" --format json",
                "dws doc folder create --name \"子文件夹\" --folder PARENT_DOC_FOLDER_NODE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_folder",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_folder",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.create_folder",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc folder create 兼容入口创建文件夹时。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc folder create 兼容入口创建文件夹时。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_folder"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_folder",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc folder create",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_folder",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_folder",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_folder"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc folder create 兼容入口创建文件夹时。"
      ]
    },
    "doc import get": {
      "agent_summary": "查询文档导入任务结果",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要发起文档导入时不要使用；本命令只查询已有 taskId 的导入结果"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档导入任务结果",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "查询文档导入任务结果",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要发起文档导入时不要使用；本命令只查询已有 taskId 的导入结果"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要发起文档导入时不要使用；本命令只查询已有 taskId 的导入结果"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "已有导入 taskId，需要查询导入任务状态时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "已有导入 taskId，需要查询导入任务状态时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.import_get",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc import get",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-import.md"
      ],
      "use_when": [
        "已有导入 taskId，需要查询导入任务状态时"
      ]
    },
    "doc info": {
      "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要读取正文时使用 dws doc read；需要浏览目录或搜索文件时使用 drive 或 wiki"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc info --node DOC_ID --format json",
        "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取文档元信息（标题/类型/创建者/权限等）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "获取文档元信息（标题/类型/创建者/权限等）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要读取正文时使用 dws doc read；需要浏览目录或搜索文件时使用 drive 或 wiki"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要读取正文时使用 dws doc read；需要浏览目录或搜索文件时使用 drive 或 wiki"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc info --node DOC_ID --format json",
            "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc info --node DOC_ID --format json",
                "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.get_document_info",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.get_document_info",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.get_document_info",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "只需文档标题、类型、创建者、时间或权限等元信息时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需文档标题、类型、创建者、时间或权限等元信息时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "get_document_info"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.get_document_info",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc info",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_info",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info",
        "skills/mono/references/intent-guide.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-info.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_info",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_info"
      ],
      "use_when": [
        "只需文档标题、类型、创建者、时间或权限等元信息时"
      ]
    },
    "doc list": {
      "agent_summary": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规浏览文件目录使用 dws drive list，浏览知识库节点使用 dws wiki node list；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc list --format json",
        "dws doc list --folder DOC_FOLDER_NODE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规浏览文件目录使用 dws drive list，浏览知识库节点使用 dws wiki node list；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规浏览文件目录使用 dws drive list，浏览知识库节点使用 dws wiki node list；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc list --format json",
            "dws doc list --folder DOC_FOLDER_NODE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc list --format json",
                "dws doc list --folder DOC_FOLDER_NODE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_nodes",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_nodes",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.list_nodes",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc list 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc list 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_nodes"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_nodes",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc list",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_nodes",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_nodes",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_nodes"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc list 兼容入口时"
      ]
    },
    "doc media download": {
      "agent_summary": "获取文档附件的临时下载链接",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要上传或插入附件时不要使用；该命令只获取已有文档附件的临时下载链接。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc media download --node DOC_ID --resource-id RESOURCE_ID --format json",
        "dws doc media download --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --resource-id RESOURCE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取文档附件的临时下载链接",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "获取文档附件的临时下载链接",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要上传或插入附件时不要使用；该命令只获取已有文档附件的临时下载链接。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要上传或插入附件时不要使用；该命令只获取已有文档附件的临时下载链接。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc media download --node DOC_ID --resource-id RESOURCE_ID --format json",
            "dws doc media download --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --resource-id RESOURCE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc media download --node DOC_ID --resource-id RESOURCE_ID --format json",
                "dws doc media download --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --resource-id RESOURCE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.download_doc_attachment",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.download_doc_attachment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要获取文档附件的临时下载链接时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要获取文档附件的临时下载链接时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "download_doc_attachment"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.download_doc_attachment",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc media download",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-media.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_doc_attachment"
      ],
      "use_when": [
        "需要获取文档附件的临时下载链接时"
      ]
    },
    "doc media insert": {
      "agent_summary": "上传本地文件并作为附件插入文档",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需上传文件但不插入文档，或目标文档和插入位置未确认时不要使用。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc media insert --node DOC_ID --file ./report.pdf --format json",
        "dws doc media insert --node DOC_ID --file ./data.bin --name \"数据文件.dat\" --mime-type application/octet-stream --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "上传本地文件并作为附件插入文档",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "上传本地文件并作为附件插入文档",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需上传文件但不插入文档，或目标文档和插入位置未确认时不要使用。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需上传文件但不插入文档，或目标文档和插入位置未确认时不要使用。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/catalog-completeness.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "dws-command-surface-review marks this tool as reviewed",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/catalog-completeness.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "dws-command-surface-review marks this tool as reviewed"
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc media insert --node DOC_ID --file ./report.pdf --format json",
            "dws doc media insert --node DOC_ID --file ./data.bin --name \"数据文件.dat\" --mime-type application/octet-stream --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc media insert --node DOC_ID --file ./report.pdf --format json",
                "dws doc media insert --node DOC_ID --file ./data.bin --name \"数据文件.dat\" --mime-type application/octet-stream --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "composite",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "interface_reason": {
          "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/catalog-completeness.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "dws-command-surface-review marks this tool as reviewed"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要上传本地文件并作为附件插入文档时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要上传本地文件并作为附件插入文档时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.media_insert",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc media insert",
        "internal/cli/schema_hints/catalog-completeness.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-media.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.media_insert"
      ],
      "use_when": [
        "需要上传本地文件并作为附件插入文档时"
      ]
    },
    "doc move": {
      "agent_summary": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规移动文档或文件时使用 dws drive move；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc move --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
        "dws doc move --node DOC_ID --workspace TARGET_WS_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规移动文档或文件时使用 dws drive move；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规移动文档或文件时使用 dws drive move；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc move --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
            "dws doc move --node DOC_ID --workspace TARGET_WS_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc move --node DOC_ID --folder TARGET_DOC_FOLDER_NODE_ID --format json",
                "dws doc move --node DOC_ID --workspace TARGET_WS_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.move_document",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.move_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc move 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc move 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "move_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.move_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc move",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.move_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.move_document"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc move 兼容入口时"
      ]
    },
    "doc permission add": {
      "agent_summary": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规新增文档空间协作者时使用 dws drive permission add；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc permission add --node DOC_ID --users uid1 --role READER --format json",
        "dws doc permission add --node DOC_ID --users uid1,uid2,uid3 --role EDITOR --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规新增文档空间协作者时使用 dws drive permission add；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规新增文档空间协作者时使用 dws drive permission add；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission add --node DOC_ID --users uid1 --role READER --format json",
            "dws doc permission add --node DOC_ID --users uid1,uid2,uid3 --role EDITOR --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc permission add --node DOC_ID --users uid1 --role READER --format json",
                "dws doc permission add --node DOC_ID --users uid1,uid2,uid3 --role EDITOR --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.add_permission",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.add_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc permission add 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc permission add 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "add_permission"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.add_permission",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc permission add",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.add_permission"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc permission add 兼容入口时"
      ]
    },
    "doc permission list": {
      "agent_summary": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规查询文档空间协作者时使用 dws drive permission list；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc permission list --node DOC_ID --format json",
        "dws doc permission list --node DOC_ID --limit 100 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规查询文档空间协作者时使用 dws drive permission list；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规查询文档空间协作者时使用 dws drive permission list；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission list --node DOC_ID --format json",
            "dws doc permission list --node DOC_ID --limit 100 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc permission list --node DOC_ID --format json",
                "dws doc permission list --node DOC_ID --limit 100 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_permission",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc permission list 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc permission list 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_permission"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_permission",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc permission list",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_permission"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc permission list 兼容入口时"
      ]
    },
    "doc permission remove": {
      "agent_summary": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规移除文档空间协作者时使用 dws drive permission remove；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc permission remove --node DOC_ID --users uid1 --format json",
        "dws doc permission remove --node DOC_ID --users uid1,uid2,uid3 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规移除文档空间协作者时使用 dws drive permission remove；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规移除文档空间协作者时使用 dws drive permission remove；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "internal/cli/schema_hints/destructive-safety.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "destructive-safety-review is an explicit Agent hint source",
          "candidates": [
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/destructive-safety.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "destructive-safety-review is an explicit Agent hint source"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "internal/cli/schema_hints/destructive-safety.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "destructive-safety-review is an explicit Agent hint source",
          "candidates": [
            {
              "value": "destructive",
              "source": "internal/cli/schema_hints/destructive-safety.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "destructive-safety-review is an explicit Agent hint source"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission remove --node DOC_ID --users uid1 --format json",
            "dws doc permission remove --node DOC_ID --users uid1,uid2,uid3 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc permission remove --node DOC_ID --users uid1 --format json",
                "dws doc permission remove --node DOC_ID --users uid1,uid2,uid3 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.remove_permission",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.remove_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "internal/cli/schema_hints/destructive-safety.json",
          "precedence": "explicit",
          "resolution": "highest_precedence",
          "review_reason": "destructive-safety-review is an explicit Agent hint source",
          "candidates": [
            {
              "value": "high",
              "source": "internal/cli/schema_hints/destructive-safety.json",
              "precedence": "explicit",
              "selected": true,
              "review_reason": "destructive-safety-review is an explicit Agent hint source"
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc permission remove 兼容入口，并已确认撤权目标时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc permission remove 兼容入口，并已确认撤权目标时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "remove_permission"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.remove_permission",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc permission remove",
        "internal/cli/schema_hints/destructive-safety.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.remove_permission"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc permission remove 兼容入口，并已确认撤权目标时"
      ]
    },
    "doc permission update": {
      "agent_summary": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规更新文档空间协作者角色时使用 dws drive permission update；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "skill-explicit",
      "examples": [
        "dws doc permission update --node DOC_ID --users uid1 --role EDITOR --format json",
        "dws doc permission update --node DOC_ID --users uid1,uid2 --role READER --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规更新文档空间协作者角色时使用 dws drive permission update；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规更新文档空间协作者角色时使用 dws drive permission update；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "write",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission update --node DOC_ID --users uid1 --role EDITOR --format json",
            "dws doc permission update --node DOC_ID --users uid1,uid2 --role READER --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc permission update --node DOC_ID --users uid1 --role EDITOR --format json",
                "dws doc permission update --node DOC_ID --users uid1,uid2 --role READER --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_permission",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "skills/mono/SKILL.md",
          "precedence": "skill",
          "resolution": "highest_precedence",
          "review_reason": "Skill danger table explicitly reviews this operation",
          "candidates": [
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": true,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc permission update 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc permission update 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_permission"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_permission",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc permission update",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_hints/sibling-disambiguation.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_permission"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc permission update 兼容入口时"
      ]
    },
    "doc read": {
      "agent_summary": "读取文档内容（Markdown）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需标题、类型或权限等元信息时使用 dws doc info；普通非在线文件先用 drive info/download"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc read --node DOC_ID --format json",
        "dws doc read --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "读取文档内容（Markdown）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "读取文档内容（Markdown）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需标题、类型或权限等元信息时使用 dws doc info；普通非在线文件先用 drive info/download"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需标题、类型或权限等元信息时使用 dws doc info；普通非在线文件先用 drive info/download"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc read --node DOC_ID --format json",
            "dws doc read --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc read --node DOC_ID --format json",
                "dws doc read --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.get_document_content",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.get_document_content",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.get_document_content",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要读取在线文档正文内容时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要读取在线文档正文内容时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "get_document_content"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.get_document_content",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc read",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-read.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_content",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_content"
      ],
      "use_when": [
        "需要读取在线文档正文内容时"
      ]
    },
    "doc rename": {
      "agent_summary": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规重命名文档或文件时使用 dws drive rename；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc rename --node DOC_ID --name \"新名称\" --format json",
        "dws doc rename --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --name \"项目周报 v2\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规重命名文档或文件时使用 dws drive rename；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规重命名文档或文件时使用 dws drive rename；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc rename --node DOC_ID --name \"新名称\" --format json",
            "dws doc rename --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --name \"项目周报 v2\" --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc rename --node DOC_ID --name \"新名称\" --format json",
                "dws doc rename --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --name \"项目周报 v2\" --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.rename_document",
          "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
          "precedence": "mcp_fallback",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.rename_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": true
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc rename 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc rename 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "rename_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.rename_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc rename",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.rename_document"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc rename 兼容入口时"
      ]
    },
    "doc search": {
      "agent_summary": "搜索文档（不传关键词返回最近访问）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规搜索不要选择该兼容入口：全局搜索优先使用 dws drive search，知识库内搜索使用 dws wiki node search。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws doc search --query \"会议纪要\" --format json",
        "dws doc search --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "搜索文档（不传关键词返回最近访问）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "搜索文档（不传关键词返回最近访问）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规搜索不要选择该兼容入口：全局搜索优先使用 dws drive search，知识库内搜索使用 dws wiki node search。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规搜索不要选择该兼容入口：全局搜索优先使用 dws drive search，知识库内搜索使用 dws wiki node search。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc search --query \"会议纪要\" --format json",
            "dws doc search --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc search --query \"会议纪要\" --format json",
                "dws doc search --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.search_documents",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.search_documents",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.search_documents",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc search 兼容入口搜索文档时。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc search 兼容入口搜索文档时。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "search_documents"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.search_documents",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc search",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.search_documents",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents",
        "skills/mono/references/intent-guide.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.search_documents",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.search_documents"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc search 兼容入口搜索文档时。"
      ]
    },
    "doc template apply": {
      "agent_summary": "使用模板创建新文档",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "仅需列出或搜索模板时不要使用；本命令会基于已知 templateId 创建新文档"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc template apply --template-id TPL_ID --name \"我的周报\" --format json",
        "dws doc template apply --template-id TPL_ID --name \"项目方案\" --folder FOLDER_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "使用模板创建新文档",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "使用模板创建新文档",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "仅需列出或搜索模板时不要使用；本命令会基于已知 templateId 创建新文档"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅需列出或搜索模板时不要使用；本命令会基于已知 templateId 创建新文档"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template apply --template-id TPL_ID --name \"我的周报\" --format json",
            "dws doc template apply --template-id TPL_ID --name \"项目方案\" --folder FOLDER_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc template apply --template-id TPL_ID --name \"我的周报\" --format json",
                "dws doc template apply --template-id TPL_ID --name \"项目方案\" --folder FOLDER_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要使用模板创建新文档时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要使用模板创建新文档时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_apply",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc template apply",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要使用模板创建新文档时"
      ]
    },
    "doc template list": {
      "agent_summary": "列出当前用户可用的文档模板",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要按关键词定位模板时使用 dws doc template search；需要应用模板时使用 template apply"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc template list --format json",
        "dws doc template list --source MY --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "列出当前用户可用的文档模板",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "列出当前用户可用的文档模板",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要按关键词定位模板时使用 dws doc template search；需要应用模板时使用 template apply"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要按关键词定位模板时使用 dws doc template search；需要应用模板时使用 template apply"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template list --format json",
            "dws doc template list --source MY --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc template list --format json",
                "dws doc template list --source MY --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要浏览当前用户可用的文档模板时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要浏览当前用户可用的文档模板时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_list",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc template list",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要浏览当前用户可用的文档模板时"
      ]
    },
    "doc template search": {
      "agent_summary": "按关键词搜索文档模板",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要浏览全部可用模板时使用 dws doc template list；需要应用模板时使用 template apply"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc template search --query \"周报\" --format json",
        "dws doc template search --query \"会议纪要\" --limit 10 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "按关键词搜索文档模板",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "按关键词搜索文档模板",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要浏览全部可用模板时使用 dws doc template list；需要应用模板时使用 template apply"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要浏览全部可用模板时使用 dws doc template list；需要应用模板时使用 template apply"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template search --query \"周报\" --format json",
            "dws doc template search --query \"会议纪要\" --limit 10 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc template search --query \"周报\" --format json",
                "dws doc template search --query \"会议纪要\" --limit 10 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要按关键词定位文档模板时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要按关键词定位文档模板时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_search",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc template search",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要按关键词定位文档模板时"
      ]
    },
    "doc update": {
      "agent_summary": "更新文档内容（追加 / 覆盖）",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需读取文档，或追加与覆盖模式、目标文档及新内容尚未确认时不要更新。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "command-verb",
      "examples": [
        "dws doc update --node DOC_ID --content \"# 新内容\" --mode append --format json",
        "dws doc update --node DOC_ID --content \"# 完整替换\" --mode overwrite --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新文档内容（追加 / 覆盖）",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "更新文档内容（追加 / 覆盖）",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需读取文档，或追加与覆盖模式、目标文档及新内容尚未确认时不要更新。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需读取文档，或追加与覆盖模式、目标文档及新内容尚未确认时不要更新。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "command-verb",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc update --node DOC_ID --content \"# 新内容\" --mode append --format json",
            "dws doc update --node DOC_ID --content \"# 完整替换\" --mode overwrite --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc update --node DOC_ID --content \"# 新内容\" --mode append --format json",
                "dws doc update --node DOC_ID --content \"# 完整替换\" --mode overwrite --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "mcp",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_document",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_document",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "doc.update_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要更新文档内容（追加 / 覆盖）时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要更新文档内容（追加 / 覆盖）时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_document",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc update",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.update_document",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/doc-update.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.update_document",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document"
      ],
      "use_when": [
        "需要更新文档内容（追加 / 覆盖）时"
      ]
    },
    "doc upload": {
      "agent_summary": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "常规上传文件时使用 dws drive upload；仅为兼容既有 doc 命令调用时使用本入口。"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc upload --file ./report.pdf --format json",
        "dws doc upload --file ./slides.pptx --name \"Q1汇报.pptx\" --folder DOC_FOLDER_NODE_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规上传文件时使用 dws drive upload；仅为兼容既有 doc 命令调用时使用本入口。"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "常规上传文件时使用 dws drive upload；仅为兼容既有 doc 命令调用时使用本入口。"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "risk-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/catalog-completeness.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "dws-command-surface-review marks this tool as reviewed",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/catalog-completeness.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "dws-command-surface-review marks this tool as reviewed"
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc upload --file ./report.pdf --format json",
            "dws doc upload --file ./slides.pptx --name \"Q1汇报.pptx\" --folder DOC_FOLDER_NODE_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc upload --file ./report.pdf --format json",
                "dws doc upload --file ./slides.pptx --name \"Q1汇报.pptx\" --folder DOC_FOLDER_NODE_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "composite",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "interface_reason": {
          "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source",
          "candidates": [
            {
              "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "agent-selection-contract-v1 is a reviewed Agent hint source"
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/selection-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/selection-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/catalog-completeness.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "dws-command-surface-review marks this tool as reviewed"
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "effect-default",
          "precedence": "inference_or_default",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "仅在用户或既有脚本明确要求使用 dws doc upload 兼容入口时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "仅在用户或既有脚本明确要求使用 dws doc upload 兼容入口时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.upload",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc upload",
        "internal/cli/schema_hints/catalog-completeness.json",
        "internal/cli/schema_hints/selection-review.json",
        "internal/cli/schema_manual_hints.json",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.upload"
      ],
      "use_when": [
        "仅在用户或既有脚本明确要求使用 dws doc upload 兼容入口时"
      ]
    },
    "doc version list": {
      "agent_summary": "列出文档历史版本",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要保存当前快照或回滚版本时不要使用；本命令只读取版本列表"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc version list --node DOC_ID --format json",
        "dws doc version list --node DOC_ID --limit 10 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "列出文档历史版本",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "列出文档历史版本",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要保存当前快照或回滚版本时不要使用；本命令只读取版本列表"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要保存当前快照或回滚版本时不要使用；本命令只读取版本列表"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version list --node DOC_ID --format json",
            "dws doc version list --node DOC_ID --limit 10 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc version list --node DOC_ID --format json",
                "dws doc version list --node DOC_ID --limit 10 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要查看文档已有历史版本及版本号时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要查看文档已有历史版本及版本号时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_list",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc version list",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要查看文档已有历史版本及版本号时"
      ]
    },
    "doc version revert": {
      "agent_summary": "将文档回滚到指定版本",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需查看版本或保存快照时不要使用；未明确目标版本时不要回滚"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc version revert --node DOC_ID --version 3 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "将文档回滚到指定版本",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "将文档回滚到指定版本",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需查看版本或保存快照时不要使用；未明确目标版本时不要回滚"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需查看版本或保存快照时不要使用；未明确目标版本时不要回滚"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "destructive",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "read",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version revert --node DOC_ID --version 3 --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc version revert --node DOC_ID --version 3 --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "idempotent",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed",
          "candidates": [
            {
              "value": "high",
              "source": "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "runtime-confirmation-review-v1 marks this tool as reviewed"
            },
            {
              "value": "low",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "需要将文档回滚到指定版本时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要将文档回滚到指定版本时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_revert",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc version revert",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_hints/zz-runtime-confirmation-review.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要将文档回滚到指定版本时"
      ]
    },
    "doc version save": {
      "agent_summary": "保存当前文档版本快照",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "只需查看已有版本或回滚到旧版本时不要使用"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws doc version save --node DOC_ID --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "保存当前文档版本快照",
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": "保存当前文档版本快照",
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需查看已有版本或回滚到旧版本时不要使用"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "只需查看已有版本或回滚到旧版本时不要使用"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version save --node DOC_ID --format json"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "dws doc version save --node DOC_ID --format json"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "local",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "local",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode local forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode local forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            },
            {
              "value": false,
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
          "precedence": "unreviewed_explicit",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "internal/cli/schema_hints/runtime-surface-completeness.json",
              "precedence": "unreviewed_explicit",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "需要保存当前文档版本快照时"
          ],
          "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
          "precedence": "reviewed_manual",
          "resolution": "highest_precedence",
          "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
          "candidates": [
            {
              "value": [
                "需要保存当前文档版本快照时"
              ],
              "source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
              "precedence": "reviewed_manual",
              "selected": true,
              "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "local",
      "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_save",
        "Skill:skills/mono/references/products/doc.md",
        "cobra-help:dws doc version save",
        "internal/cli/schema_hints/runtime-surface-completeness.json",
        "internal/cli/schema_manual_hints.json"
      ],
      "use_when": [
        "需要保存当前文档版本快照时"
      ]
    }
  }
}