| name | dingtalk-minutes |
| description | 钉钉 AI 听记。Use when 查询听记摘要、转写、关键词、待办或分享。写文档走 dingtalk-doc；日程走 dingtalk-calendar。 |
| metadata | {"cli_version":">=0.2.14","category":"product","requires":{"bins":["dws"]}} |
钉钉 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.com URL 必须走 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-todo sub-skill 内可用，未切换前不要在当前 skill 运行。
- 摘要发给同事 → 切到
dingtalk-chat
- 日程 / 会议室 → 切到
dingtalk-calendar
局部意图与短流程
