170 lines
7.9 KiB
JSON
170 lines
7.9 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.listen_im": {
|
|
"agent_summary": "按 @我、姓名、群名或全量范围监听一个或多个 IM 消息事件",
|
|
"use_when": [
|
|
"已知要监听 @我、指定发送人、指定群、全部单聊或全部群聊的 message/reaction/read/recall 事件时使用；姓名用 --user-query、群名用 --chat-query，CLI 会唯一解析目标并把多个兼容事件合并到一个消费生命周期。"
|
|
],
|
|
"avoid_when": [
|
|
"需要群标题/成员/解散等生命周期事件、显式 EventKey、复用 subscribe_id、Filter DSL、原始 transport envelope 或其它底层 consume 控制时使用 event consume；只查历史消息时使用 chat 查询入口"
|
|
],
|
|
"examples": [
|
|
"dws event +listen-im --kind at-me --max-events 1",
|
|
"dws event +listen-im --kind group --events message,reaction --chat-id <openConversationId> --duration 10m"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "Agent-authored from the verified deterministic mapping table, typed natural target resolver, one-process multi-event delegation, flatten/NDJSON defaults, bounded execution flags, and explicit fallback boundary to low-level event consume.",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry/products/event.json#event.listen_im",
|
|
"cobra-help:dws event +listen-im",
|
|
"internal/event/personal/registry.go",
|
|
"internal/app/event_listen_im.go"
|
|
]
|
|
},
|
|
"event.consume": {
|
|
"agent_summary": "订阅并持续消费一个或多个兼容的个人事件；Agent 使用 --flatten 输出顶层业务 NDJSON",
|
|
"use_when": [
|
|
"需要监听指定群的标题变更、成员进退群或群解散事件",
|
|
"需要显式 EventKey、复用 subscribe_id、Filter DSL、原始 transport envelope 或其它底层 consume 控制"
|
|
],
|
|
"avoid_when": [
|
|
"普通 @我、指定发送人、指定群、全部单聊/群消息以及 message/reaction/read/recall 组合使用 +listen-im",
|
|
"只查历史聊天记录时用 chat 查询命令",
|
|
"只看事件目录/字段时用 event list / event schema"
|
|
],
|
|
"examples": [
|
|
"dws event consume user_im_message_receive_user --open-dingtalk-id open-example --flatten --max-events 1 --format ndjson",
|
|
"dws event consume user_im_message_receive_o2o user_im_message_read_o2o --user test-user-001 --flatten --max-events 2 --format ndjson"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry/products/event.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/products/event.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": "查询指定个人事件码的输出字段结构；Agent 应查询 --flatten 模式",
|
|
"use_when": [
|
|
"已知任一公开个人 IM event_key，消费前需要理解输出字段或保守 payload 契约"
|
|
],
|
|
"avoid_when": [
|
|
"查询 CLI 命令参数契约时用顶层 dws schema",
|
|
"要实际收事件时用 event consume"
|
|
],
|
|
"examples": [
|
|
"dws event schema user_im_message_receive_at --flatten --format json"
|
|
],
|
|
"reviewed": true,
|
|
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
|
|
"source_refs": [
|
|
"internal/cli/schema_command_registry/products/event.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/products/event.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/products/event.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/registry.json",
|
|
"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"
|
|
]
|
|
}
|
|
}
|
|
}
|