{
  "product_id": "devdoc",
  "tools": {
    "devdoc article search": {
      "agent_summary": "按关键词搜索 open.dingtalk.com 开放平台文档",
      "agent_summary_source": "internal/cli/schema_manual_hints.json#agent_hints@ai-agent-contract-2026-07-13-v1",
      "availability": "available",
      "avoid_when": [
        "需要查询业务数据或执行 OpenAPI 时不要使用；该命令只检索开放平台文档、字段和错误码说明。"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "command-verb",
      "examples": [
        "dws devdoc article search \"MCP\" --format json",
        "dws devdoc article search --query \"MCP\" --page 1 --size 10 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "按关键词搜索 open.dingtalk.com 开放平台文档",
          "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": "按关键词搜索 open.dingtalk.com 开放平台文档",
              "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.devdoc.search_open_platform_docs_rag.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要查询业务数据或执行 OpenAPI 时不要使用；该命令只检索开放平台文档、字段和错误码说明。"
          ],
          "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": [
                "需要查询业务数据或执行 OpenAPI 时不要使用；该命令只检索开放平台文档、字段和错误码说明。"
              ],
              "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 devdoc article search \"MCP\" --format json",
            "dws devdoc article search --query \"MCP\" --page 1 --size 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 devdoc article search \"MCP\" --format json",
                "dws devdoc article search --query \"MCP\" --page 1 --size 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": "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.devdoc.search_open_platform_docs_rag.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "devdoc.search_open_platform_docs",
          "source": "internal/cli/schema_hints/imported/wukong.json",
          "precedence": "imported",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "devdoc.search_open_platform_docs",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": true
            },
            {
              "value": "devdoc.search_open_platform_docs",
              "source": "internal/cli/schema_mcp_metadata.json#tools.devdoc.search_open_platform_docs_rag.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": [
            "需要查找钉钉 OpenAPI、字段、错误码或接入指南时"
          ],
          "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": [
                "需要查找钉钉 OpenAPI、字段、错误码或接入指南时"
              ],
              "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": "devdoc",
        "rpc_name": "search_open_platform_docs"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=devdoc.search_open_platform_docs_rag",
        "Skill:skills/mono/references/products/devdoc.md",
        "cobra-help:dws devdoc article search",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.devdoc.prod.json#devdoc.search_open_platform_docs",
        "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.devdoc.search_open_platform_docs_rag",
        "skills/mono/references/products/devdoc.md",
        "skills/mono/references/products/simple.md",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#devdoc.search_open_platform_docs_rag",
        "structured-hint:internal/cli/schema_hints/selection-review.json#devdoc.search_open_platform_docs_rag"
      ],
      "use_when": [
        "需要查找钉钉 OpenAPI、字段、错误码或接入指南时"
      ]
    }
  }
}