Files
dingtalk-workspace-cli/internal/cli/schema_hints/selection/event.json
玉澜andCursor 5856a897d1 feat(schema): split human hints into metadata and selection
Own safety/gates/parameters in metadata/ and Agent prose in selection/,
drop the monolithic Manual file, and keep confirmation aligned with
per-tool runtime_gate.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-14 13:40:09 +08:00

146 lines
5.8 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": [
"需要实时监听 @我、指定单聊或指定群的后续消息事件"
],
"avoid_when": [
"只查历史聊天记录时用 chat 查询命令",
"只看事件目录/字段时用 event list / event schema"
],
"examples": [
"dws event consume user_im_message_receive_at --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,消费前需要理解 payload 字段"
],
"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": "订阅/消费个人消息事件,并查询目录、Schema、状态或停止订阅",
"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"
]
}
}
}