Files
dingtalk-workspace-cli/internal/cli/schema_hints/selection/dev.json
T
玉澜andCursor 9911d8f9c9 feat(schema): consume Contract declarations in agent-metadata, drop devapp hints
The agent-metadata generator now merges each registered Contract final
overlay (cmdcore.SchemaDecl) as the top-precedence contract_final
candidate, so declared tools no longer need hint-file rows for
agent_summary/use_when/avoid_when/examples/safety/interface. Selection
eval fixtures and example execution plans synthesize the same assertions
from the declaration, keeping semantic-eval and example coverage intact.

- devapp hint rows deleted from schema_hints/{metadata,selection}/dev.json
  (connect_status/connect_stop/search_open_platform_docs_rag kept);
  artifact content for all 31 declared leaves is byte-identical, only
  provenance now reads contract_final / cmdcore.SchemaDecl
- exact-coverage gates exempt declared tools (hints remain required for
  every non-declared command); reviewed-delivery gate accepts
  contract_final as the stronger reviewed source
- cmdcore derives effect_source=cmdcore.contract for SchemaDecl-only
  safety (read leaves), matching the Risk-shorthand path

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-30 20:37:34 +08:00

95 lines
3.6 KiB
JSON

{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-agent-selection/dev",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"dev.connect_status": {
"agent_summary": "查看后台连接器守护进程状态",
"use_when": [
"需要确认本地 connect 守护进程是否在跑、pid/日志路径"
],
"avoid_when": [
"要停止守护进程时用 dev connect stop"
],
"examples": [
"dws dev connect status --unified-app-id <unifiedAppId> --json"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#dev.connect_status",
"cobra-help:dws dev connect status",
"skills/mono/SKILL.md",
"skills/mono/references/products/dev.md",
"live-dws-schema:dev.connect_status#FAILED"
]
},
"dev.connect_stop": {
"agent_summary": "优雅停止后台连接器守护进程",
"use_when": [
"用户明确要求停止本地 Stream/连接器守护进程"
],
"avoid_when": [
"只想查看状态时用 dev connect status"
],
"examples": [
"dws dev connect stop --unified-app-id <unifiedAppId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#dev.connect_stop",
"cobra-help:dws dev connect stop",
"skills/mono/SKILL.md",
"skills/mono/references/products/dev.md",
"live-dws-schema:dev.connect_stop#FAILED"
]
},
"dev.search_open_platform_docs_rag": {
"agent_summary": "通过 dev 兼容入口搜索开放平台文档",
"use_when": [
"明确需要验证或使用 dev doc search 入口时"
],
"avoid_when": [
"常规开放平台文档检索优先使用可用的 devdoc article search"
],
"examples": [
"dws dev doc search --query \"MCP\" --size 10"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#dev.search_open_platform_docs_rag",
"cobra-help:dws dev doc search",
"skills/mono/SKILL.md",
"skills/mono/references/products/dev.md"
]
}
},
"products": {
"dev": {
"agent_summary": "管理开放平台应用、权限、机器人、版本发布与本地连接器",
"use_when": [
"创建/配置开放平台应用、机器人、权限、事件订阅或发布版本"
],
"avoid_when": [
"只查开放平台文档用 devdoc;业务聊天/邮信用 chat/mail"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"skills/mono/references/products/dev.md",
"CommandRegistry:product=dev",
"Skill:skills/mono/references/products/dev.md",
"live-dws-schema:product-batch-2026-07-14"
]
}
}
}