crimsonblazezero 钉钉 AI 听记 Skill
前置条件 — 执行操作前必读
**CRITICAL — 执行任何
dws操作前，MUST 先用 Read 工具完整读取dws-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。
命令参考：minutes.md；剧本：07-minutes.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 同时进入公开 catalog 与 Runtime Schema。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 leaf Schema（例如 dws schema --cli-path "minutes +<shortcut>" --format json）读取 Agent 选择、参数、约束、风险和确认语义；用 dws shortcut list --service minutes --format json 批量发现；最后以 dws minutes <shortcut> --help 核对当前 Cobra flags。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws minutes +detail |
read | 一条命令聚合取一条妙记（听记）的多项产物（基础信息/摘要/关键词/逐字稿/待办） |
dws minutes +list-all |
read | 查询我有权限访问的所有听记列表 |
dws minutes +list-mine |
read | 查询我创建的听记列表 |
dws minutes +list-shared |
read | 查询他人共享给我的听记列表 |
dws minutes +record-start |
write | 发起听记（开始录音） |
dws minutes +replace-batch |
write | 对一条妙记（听记）批量执行多组文字替换（原文=>替换） |
意图表
| 用户说 | 命令 |
|---|---|
| "我的听记列表" | dws minutes list mine [--query "<关键词>"] [--start "<ISO>"] [--end "<ISO>"] |
| "查某段时间/最近/本周/上月的听记" | dws minutes list all --start "<ISO>" --end "<ISO>" [--query "<关键词>"] |
| "看一篇听记摘要" | dws minutes get summary --id <taskUuid> |
| "看转写 / 原文" | dws minutes get transcription --id <taskUuid> |
| "下载/导出最近一周听记原文/逐字稿" | dws minutes list all --start "<ISO>" --end "<ISO>" → 逐条 dws minutes get transcription --id <taskUuid> |
| "近期听记摘要合并" | python scripts/minutes_recent_summary.py --max 5 |
| "提取会议待办" | python scripts/minutes_extract_todos.py --id <taskUuid> |
| "改听记标题" | dws minutes update title --id <taskUuid> --title "<新标题>" |
标准 SOP（必遵流程）
命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 taskUuid。每条命令必须带
--format json。锁定目标必须按taskUuid + title + organizationName + 时间精准匹配，禁止凭标题相似度乱选。
SOP-1 查听记列表（query-minutes）
触发：查听记/会议记录/某会议的纪要/按关键词或时间找听记。
- 选 scope（必须·铁律）：
mine=我创建/发起的；shared=他人共享给我的；all=我可访问的全部（含 mine+shared）。用户说"我能访问/可见/所有/我的听记"等覆盖语义一律all；只有明确"我创建的/我发起的/我录的"才用mine。 - 执行（必须）：
dws minutes list all|mine|shared --format json；按关键词加--query "<关键词>"，按时间加--start "<ISO>" --end "<ISO>"，限制条数--limit <n>（--max兼容别名），翻页用--cursor <token>（--next-token兼容别名）。 - 解析（必须）：从
itemList[]取真实taskUuid+title+ 时间；多候选必须让用户确认，禁止默认取第一条。
禁止：把 mine 当全量、凭标题相似度锁定、跳过 --format json。
SOP-2 取听记详情（get-minute-detail）
触发：要摘要/转写原文/关键词/待办/基础信息/音频。
- 前置（必须）：先按 SOP-1 拿到目标
taskUuid。 - 执行（必须·按需选一）：摘要
dws minutes get summary --id <taskUuid>；转写原文dws minutes get transcription --id <taskUuid>（返回cursor/nextToken时必须继续--cursor翻页拉全）；关键词get keywords；待办get todos；基础信息get info；音频地址get audio；批量get batch --ids <uuid1,uuid2>。全部带--format json。 - 解析（必须）：
--id/--uuid/--task-uuid三者等价，推荐统一--id；转写/摘要按用户需要抽取，禁止无差别全文贴出。
禁止：编造 taskUuid、转写有分页不翻完就总结、跳过 SOP-1 直接猜 ID。
SOP-3 听记转文档 / 待办回写（handoff）
触发：把会议纪要转成文档/把听记待办建到待办系统。
- 转文档（必须）：取
minutes get summary/transcription内容 → 切dingtalk-doc用dws doc create --content-file <tmp.md>落盘。 - 待办回写（必须）：取
minutes get todos的待办项 → 切dingtalk-todo按 SOP-1 解析执行者 userId 后todo task create。
禁止：在 minutes 内直接写文档/建待办（应切对应 skill）。
高频硬约束
shanji.dingtalk.comURL 必须走dws minutes，禁止用浏览器或read_file打开链接。自动提取 taskUuid 后调用get info/summary/transcription/todos。- 用户给了时间线索（今天、本周、上周、上月、最近 N 天、某日期范围）时，必须自行计算
--start/--end，格式用 ISO-8601，如2026-05-11T00:00:00+08:00。不要反问用户时间范围。 - 未指定 mine/shared 时，检索型任务默认
list all；如果只查"我创建的"才用list mine。 - 不要全量拉取后本地过滤时间。时间范围和关键词能服务端过滤时必须放进同一条
list all --start --end --query。 - 列表为空时按顺序兜底：同范围
list all→ 去掉关键词但保留时间范围 → 明确告知无数据。禁止用模板或虚构听记内容继续生成纪要/周报。 - 生成纪要、文档、待办、周报前，必须先完成
list→ 选定真实taskUuid→get summary；需要原文或行动项时继续get transcription/get todos。前置数据没拿到就停止并说明卡点。 - 用户明确说"下载/导出/文件"且对象是"听记原文/逐字稿/转写/完整记录"时，不能降级为摘要汇总：必须
list all --start --end找到范围内听记；列表为空则明确无数据；列表非空则对每条听记逐一get transcription并翻页到结束，交付内容必须包含真实转写段落。可附标题、时间等元数据，但不能只给 summary，也不能要求用户再指定某一条。 - 所有 dws 命令带
--format json，不要用 shell 管道、重定向、head、grep、jq。
跨产品协作
- 提取的待办批量建任务 → 切到
dingtalk-todo，按其批量创建 SOP 执行；批量脚本仅在dingtalk-todosub-skill 内可用，未切换前不要在当前 skill 运行。 - 摘要发给同事 → 切到
dingtalk-chat - 日程 / 会议室 → 切到
dingtalk-calendar
局部意图与短流程
- 局部意图消歧；短流程。