149 lines
6.2 KiB
JSON
149 lines
6.2 KiB
JSON
{
|
|
"version": 1,
|
|
"source": {
|
|
"kind": "explicit",
|
|
"name": "dws-agent-selection/event",
|
|
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
|
|
"channel": "open-source",
|
|
"reviewed": true
|
|
},
|
|
"tools": {
|
|
"event.consume": {
|
|
"agent_summary": "订阅并持续消费指定个人事件，输出 NDJSON 事件流",
|
|
"use_when": [
|
|
"需要实时监听 @我、指定单聊、指定群或指定发送人的后续消息事件",
|
|
"需要监听指定单聊或群聊中的消息已读、撤回或表情回应事件",
|
|
"监听机器人、外部联系人等以 openDingtalkId 标识的单聊目标"
|
|
],
|
|
"avoid_when": [
|
|
"只查历史聊天记录时用 chat 查询命令",
|
|
"只看事件目录/字段时用 event list / event schema"
|
|
],
|
|
"examples": [
|
|
"dws event consume user_im_message_receive_user --open-dingtalk-id open-example --max-events 1 --format ndjson",
|
|
"dws event consume user_im_message_reaction_group --group cid-example --max-events 1 --format ndjson"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event.consume",
|
|
"cobra-help:dws event consume --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"live-dws-schema:event.consume#FAILED",
|
|
"cobra-help:dws event consume"
|
|
]
|
|
},
|
|
"event.list": {
|
|
"agent_summary": "列出支持的个人事件目录与状态说明",
|
|
"use_when": [
|
|
"尚不知道可用 event_key，需要先盘点个人事件目录"
|
|
],
|
|
"avoid_when": [
|
|
"已知 event_key 要看 payload 字段时用 event schema",
|
|
"要开始监听时用 event consume"
|
|
],
|
|
"examples": [
|
|
"dws event list --format json"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event.list",
|
|
"cobra-help:dws event list --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"live-dws-schema:event.list#FAILED"
|
|
]
|
|
},
|
|
"event.schema": {
|
|
"agent_summary": "查询指定个人事件码的 payload 字段结构",
|
|
"use_when": [
|
|
"已知任一公开个人消息 event_key，消费前需要理解扁平输出字段"
|
|
],
|
|
"avoid_when": [
|
|
"查询 CLI 命令参数契约时用顶层 dws schema",
|
|
"要实际收事件时用 event consume"
|
|
],
|
|
"examples": [
|
|
"dws event schema user_im_message_receive_at --format json"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event.schema",
|
|
"cobra-help:dws event schema --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"live-dws-schema:event.schema#FAILED"
|
|
]
|
|
},
|
|
"event.status": {
|
|
"agent_summary": "查看个人事件订阅、本地 bus 与消费进程状态",
|
|
"use_when": [
|
|
"需要确认订阅是否活跃、bus/consume 是否仍在运行"
|
|
],
|
|
"avoid_when": [
|
|
"取消订阅用 event stop；列事件目录用 event list"
|
|
],
|
|
"examples": [
|
|
"dws event status --format json"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event.status",
|
|
"cobra-help:dws event status --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"live-dws-schema:event.status#FAILED"
|
|
]
|
|
},
|
|
"event.stop": {
|
|
"agent_summary": "取消个人事件订阅并停止对应本地消费",
|
|
"use_when": [
|
|
"用户明确要求取消已知 subscribe_id（或清理全部）并停止消费"
|
|
],
|
|
"avoid_when": [
|
|
"只需检查状态时用 event status",
|
|
"目标订阅不明确或用户未确认时不要停止"
|
|
],
|
|
"examples": [
|
|
"dws event stop SUBSCRIBE_ID --dry-run"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event.stop",
|
|
"cobra-help:dws event stop --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"live-dws-schema:event.stop#FAILED",
|
|
"note:examples-omit-yes-use-dry-run-first"
|
|
]
|
|
}
|
|
},
|
|
"products": {
|
|
"event": {
|
|
"agent_summary": "订阅/消费个人消息接收、已读、撤回和表情回应事件，并管理订阅生命周期",
|
|
"use_when": [
|
|
"需要实时监听个人消息接收、已读、撤回或表情回应事件，或管理个人事件订阅生命周期"
|
|
],
|
|
"avoid_when": [
|
|
"查历史聊天或主动发消息分别用 chat 查询/发送命令"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry.json#event",
|
|
"cobra-help:dws event --help",
|
|
"skills/mono/SKILL.md",
|
|
"skills/mono/references/products/event.md",
|
|
"CommandRegistry:product=event",
|
|
"Skill:skills/mono/references/products/event.md",
|
|
"live-dws-schema:product-batch-2026-07-14"
|
|
]
|
|
}
|
|
}
|
|
}
|