{
  "product_id": "devdoc",
  "tools": {
    "devdoc article search": {
      "agent_summary": "搜索钉钉开放平台开发文档，返回资料与链接（不生成分析答案）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "搜索用户业务文档用 drive/wiki/doc，不要用 devdoc",
        "要执行开放平台应用配置变更时用 dev"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws devdoc article search --query \"OAuth2 接入\" --format json",
        "dws devdoc article search --query \"errcode 40078\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "搜索钉钉开放平台开发文档，返回资料与链接（不生成分析答案）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "搜索钉钉开放平台开发文档，返回资料与链接（不生成分析答案）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "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": [
            "搜索用户业务文档用 drive/wiki/doc，不要用 devdoc",
            "要执行开放平台应用配置变更时用 dev"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "搜索用户业务文档用 drive/wiki/doc，不要用 devdoc",
                "要执行开放平台应用配置变更时用 dev"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws devdoc article search --query \"OAuth2 接入\" --format json",
            "dws devdoc article search --query \"errcode 40078\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws devdoc article search --query \"OAuth2 接入\" --format json",
                "dws devdoc article search --query \"errcode 40078\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "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": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "devdoc.search_open_platform_docs",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "devdoc.search_open_platform_docs",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "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": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/metadata/devdoc.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "Search text may be supplied as positional keyword or public --query; hidden --keyword remains a runtime compatibility alias and is intentionally not published as a parameter. The versioned binding owns query -\u003e keyword."
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "查 OpenAPI、字段、错误码、OAuth2、接入指南等开放平台开发问题"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "查 OpenAPI、字段、错误码、OAuth2、接入指南等开放平台开发问题"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "devdoc",
        "rpc_name": "search_open_platform_docs"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "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/metadata/devdoc.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"
      ],
      "use_when": [
        "查 OpenAPI、字段、错误码、OAuth2、接入指南等开放平台开发问题"
      ]
    }
  }
}