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

{
  "product_id": "dev",
  "tools": {
    "dev app create": {
      "agent_summary": "创建开放平台企业内部应用",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "创建应用",
        "创建开放平台企业内部应用",
        "创建开放平台应用，拿 unifiedAppId"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app create --name \"我的 AI 机器人\" --desc \"接 opencode\" --dry-run --format json",
        "dws dev app create --name \"我的 AI 机器人\" --desc \"接 opencode\" --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app credentials get": {
      "agent_summary": "读取开放平台应用凭证",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询 clientId/clientSecret（credentials 下只有 get 子命令）",
        "读取开放平台应用凭证"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app credentials get --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app delete": {
      "agent_summary": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "删除应用（不可逆，需 --confirm-name 二次确认）",
        "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）"
      ],
      "effect": "destructive",
      "effect_source": "skill-comment",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app delete --unified-app-id \u003cunifiedAppId\u003e --confirm-name \u003c应用名\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app disable": {
      "agent_summary": "停用开放平台应用，停用后应用能力对外不可用（可重新启用）",
      "agent_summary_source": "destructive-safety-review",
      "use_when": [
        "停用/启用应用"
      ],
      "effect": "write",
      "effect_source": "agent-hint",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app disable --unified-app-id \u003cunifiedAppId\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/destructive-safety.json"
      ]
    },
    "dev app enable": {
      "agent_summary": "启用开放平台企业内部应用",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "停用/启用应用",
        "启用开放平台企业内部应用"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app enable  --unified-app-id \u003cunifiedAppId\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app event list": {
      "agent_summary": "查询应用已订阅的事件列表",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询应用已订阅的事件列表"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app event list        --unified-app-id \u003cunifiedAppId\u003e --keyword \u003c关键词\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app event subscribe": {
      "agent_summary": "订阅应用事件回调",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "订阅应用事件回调"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app event subscribe   --unified-app-id \u003cunifiedAppId\u003e --event-codes \u003ccode1\u003e,\u003ccode2\u003e --dry-run --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app event unsubscribe": {
      "agent_summary": "取消订阅应用事件",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "取消订阅应用事件"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app event unsubscribe --unified-app-id \u003cunifiedAppId\u003e --event-codes \u003ccode1\u003e,\u003ccode2\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app get": {
      "agent_summary": "查询开放平台企业内部应用详情",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询单个应用详情",
        "查询开放平台企业内部应用详情"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app get --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app list": {
      "agent_summary": "查询开放平台企业内部应用列表",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询应用列表",
        "查询开放平台企业内部应用列表"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app list --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app member add": {
      "agent_summary": "添加开放平台应用成员",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "添加开放平台应用成员"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app member list": {
      "agent_summary": "查询开放平台应用成员",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询开放平台应用成员"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app member remove": {
      "agent_summary": "移除开放平台应用的协作成员",
      "agent_summary_source": "destructive-safety-review",
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/destructive-safety.json"
      ]
    },
    "dev app permission add": {
      "agent_summary": "申请开放平台应用权限点",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "申请开放平台应用权限点"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app permission add   --unified-app-id \u003cunifiedAppId\u003e --scope-values \u003cscopeValue\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app permission list": {
      "agent_summary": "查询开放平台应用权限列表",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询开放平台应用权限列表"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app permission list  --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app permission remove": {
      "agent_summary": "移除开放平台应用已授予的权限点",
      "agent_summary_source": "destructive-safety-review",
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app permission remove --unified-app-id \u003cunifiedAppId\u003e --scope-values \u003cscopeValue\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/destructive-safety.json"
      ]
    },
    "dev app robot config": {
      "agent_summary": "创建或更新现有应用的机器人配置（upsert）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "创建/更新机器人配置（upsert）",
        "创建或更新现有应用的机器人配置（upsert）",
        "在明确的 unifiedAppId 上配置机器人能力"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app robot config --unified-app-id \u003cunifiedAppId\u003e --name \"小助手\" --desc \"接 opencode\" --dry-run --format json",
        "dws dev app robot config --unified-app-id \u003cunifiedAppId\u003e --name \"小助手\" --desc \"接 opencode\" --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app robot disable": {
      "agent_summary": "停用开放平台应用的机器人（可重新启用）",
      "agent_summary_source": "destructive-safety-review",
      "use_when": [
        "启用/停用机器人"
      ],
      "effect": "write",
      "effect_source": "agent-hint",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app robot disable --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/destructive-safety.json"
      ]
    },
    "dev app robot enable": {
      "agent_summary": "启用现有应用机器人能力（纯启用，无需配置字段）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "启用/停用机器人",
        "启用现有应用机器人能力（纯启用，无需配置字段）"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app robot enable  --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app robot get": {
      "agent_summary": "查询现有应用的机器人配置",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询现有应用的机器人配置",
        "查询现有机器人配置"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app robot get --unified-app-id \u003cunifiedAppId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app robot result": {
      "agent_summary": "查询机器人异步创建任务结果",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "建号：轮询结果",
        "查询机器人异步创建任务结果"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app robot result --task-id \u003ctaskId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app robot submit": {
      "agent_summary": "异步提交钉钉智能体机器人创建任务（支持失败重试）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "建号：异步提交",
        "异步提交钉钉智能体机器人创建任务（支持失败重试）"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app robot submit --name \u003c智能体名\u003e --robot-name \u003c机器人名\u003e --desc \u003c描述\u003e --dry-run --format json",
        "dws dev app robot submit --name \u003c智能体名\u003e --robot-name \u003c机器人名\u003e --desc \u003c描述\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app security config": {
      "agent_summary": "更新开放平台应用安全配置",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "更新开放平台应用安全配置"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app update": {
      "agent_summary": "修改开放平台企业内部应用基础信息",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "修改开放平台企业内部应用基础信息",
        "更新应用信息（写操作：先 --dry-run 预览，确认后加 --yes 执行；不加 --yes 会被拦下）"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app update --unified-app-id \u003cunifiedAppId\u003e --name \u003c新名称\u003e --dry-run --format json",
        "dws dev app update --unified-app-id \u003cunifiedAppId\u003e --name \u003c新名称\u003e --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app version create": {
      "agent_summary": "基于当前配置创建应用新版本",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "基于当前配置创建应用新版本",
        "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev app version create --unified-app-id \u003cunifiedAppId\u003e --desc \"发布机器人能力\" --dry-run --format json",
        "dws dev app version create --unified-app-id \u003cunifiedAppId\u003e --desc \"发布机器人能力\" --yes --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app version get": {
      "agent_summary": "查询指定版本详情",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询指定版本详情"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app version list": {
      "agent_summary": "分页查询应用版本列表",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "分页查询应用版本列表"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app version publish": {
      "agent_summary": "发布指定版本（含高敏权限需 --confirmed-sensitive）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "发布指定版本（含高敏权限需 --confirmed-sensitive）",
        "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app version check-approval --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --format json",
        "dws dev app version publish --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --dry-run --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app version status": {
      "agent_summary": "查询版本发布/审批状态",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询版本发布/审批状态",
        "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev app version status --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --format json",
        "dws dev app version status         --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --format json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app webapp config": {
      "agent_summary": "配置网页应用能力",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "配置网页应用能力"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev app webapp get": {
      "agent_summary": "查询网页应用配置",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查询网页应用配置"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev connect status": {
      "agent_summary": "查看后台连接器守护进程状态（pid、运行时长、日志路径）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）",
        "查看后台连接器守护进程状态（pid、运行时长、日志路径）"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws dev connect status --json"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev connect stop": {
      "agent_summary": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）",
        "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws dev connect stop"
      ],
      "reviewed": true,
      "source_refs": [
        "skills/mono/references/products/dev.md",
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    },
    "dev doc search": {
      "agent_summary": "搜索开放平台文档",
      "agent_summary_source": "dws-command-surface-review",
      "use_when": [
        "搜索开放平台文档"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "reviewed": true,
      "source_refs": [
        "skills/mono/schema-hints/catalog-completeness.json"
      ]
    }
  }
}