263 lines
12 KiB
JSON
263 lines
12 KiB
JSON
{
|
|
"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": "skills/mono/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": "skills/mono/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": "skills/mono/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": "skills/mono/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": "skills/mono/schema-hints/imported/wukong.json",
|
|
"precedence": "imported",
|
|
"resolution": "highest_precedence",
|
|
"candidates": [
|
|
{
|
|
"value": "devdoc.search_open_platform_docs",
|
|
"source": "skills/mono/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_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",
|
|
"skills/mono/schema-hints/imported/wukong.json",
|
|
"skills/mono/schema-hints/selection-review.json",
|
|
"skills/mono/schema-hints/sibling-disambiguation.json",
|
|
"structured-hint:skills/mono/schema-hints/imported/wukong.json#devdoc.search_open_platform_docs_rag",
|
|
"structured-hint:skills/mono/schema-hints/selection-review.json#devdoc.search_open_platform_docs_rag"
|
|
],
|
|
"use_when": [
|
|
"需要查找钉钉 OpenAPI、字段、错误码或接入指南时"
|
|
]
|
|
}
|
|
}
|
|
}
|