Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws
dws
Unverified【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
references/best_practices/07-minutes.md
View on GitHub# 听记与会后
发言人总结使用 `+speaker-insights`:仅 `state=ready/complete=true` 且有校验后的正文才完成,`createStatus` 不代表当前状态。pending/超时不算成功,可能只是结果暂不可读;保留句柄,沿用同一 profile 和确认门禁,通过 `--resume --task-id <taskId>` 继续读,不重复创建。未知结构停止;用户指定等待时间传入 `--timeout`。
导出听记用 `+export-pack` 时,已识别签名链接会在全部文本产物中替换为 `[signed-url-removed]`,并在发布前扫描;失败不发布。交付需说明 `sanitized/redactionCount/sanitizationScope`。当前 `offlineImagesComplete=false`,不可把归档成功当作图片离线可用;二进制媒体不属于文本扫描范围,文件 hash/内容读回仍未提供。
> lite(`list-minutes`、`get-minutes-summary`、`get-minutes-transcription`)见 [lite-recipes.md](./lite-recipes.md)「#7 听记与会后」。full recipe 见下表。
> 日程、订会议室、`schedule-meeting` 见 [03-meeting.md](./03-meeting.md)。产品命令见 [minutes.md](../products/minutes.md)。
### 听记列表参数速查
`list mine` / `list shared` / `list all` 均支持以下筛选参数(**有时间/关键词条件时优先使用服务端过滤;无筛选条件时可全量拉取**):
| 参数 | 说明 | 示例 |
|------|------|------|
| `--query "<关键词>"` | 服务端关键词搜索 | `--query "周会"` |
| `--start "<ISO-8601>"` | 开始时间(含时区) | `--start "2026-05-01T00:00:00+08:00"` |
| `--end "<ISO-8601>"` | 结束时间(含时区) | `--end "2026-05-25T23:59:59+08:00"` |
| `--limit <N>` | 每页返回条数(默认 10) | `--limit 20`(`--max` 为兼容别名) |
| `--cursor "<token>"` | 分页 token(首页留空) | `--cursor "abc123"`(`--next-token` 为兼容别名) |
**组合筛选示例**:
```bash
# 按时间范围
dws minutes list all --start "2026-04-01T00:00:00+08:00" --end "2026-04-30T23:59:59+08:00" --format json
# 关键词 + 时间范围
dws minutes list mine --query "需求评审" --start "2026-05-25T00:00:00+08:00" --end "2026-05-25T23:59:59+08:00" --format json
# 限制条数
dws minutes list mine --limit 5 --format json
```
| Recipe | 行动指南(固定路线) |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| meeting-followup | 1. **提取待办优先**:单条听记用 `dws minutes +action-items --id <taskUuid>`;多条听记用 `dws minutes +detail --ids <uuid1,uuid2> --artifacts todos`,不要再调用退役脚本 2. 按[「多源信息采集」](./_common/conventions.md#多源信息采集公共模式)整理行动项 3. `aisearch person --query "<姓名>" --dimension name` → 取 `userId` → `todo task create --title "<行动项>" --executors <userId>`(每条行动项;批量时将待办写入 todos.json,先执行 `python3 scripts/todo_batch_create.py todos.json --dry-run` 预览精确批次和 planDigest,用户确认摘要后以 `--confirm-digest <PLAN_DIGEST> --yes` 正式执行,脚本核对摘要,内容变化会在首次 `dws` 调用前拒绝) 4. `chat message send --conversation-id <openConversationId> --content "<通知内容>"` 通知已创建 |
| share-minutes | 1. 先锁定真实 `taskUuid`,再用 `dws minutes +detail --id <taskUuid> --artifacts summary` 读取摘要 2. 只有用户明确要把最近若干条“我创建的”听记汇总成 Markdown 文件时,才用 `python3 scripts/minutes_recent_summary.py --max <N> --output summary.md`;它不覆盖 shared/all、完整分页或目标消歧 3. 单聊:`contact user search --query "<姓名>"` → 取 `openDingTalkId` → `chat message send --open-dingtalk-id <openDingTalkId> --content "<摘要内容>"`(推荐);群聊:`--conversation-id <openConversationId> --content "<摘要内容>"` 发送。仅当无法获取 openDingTalkId 时才用 `--user <userId>`(备选) |
| browse-minutes | 1. `minutes list all --query "<关键词>" --limit <N>` → 取 `taskUuid`;要声称完整时持续透传真实 cursor,直到端点结束(无主题筛选时仍先确认用户要 mine/shared/all;有时间范围时加 `--start`/`--end`) 2. **详情/元数据优先** `minutes get batch --ids <uuid1,uuid2,...>`(仅 API 上限时拆多批);摘要专项且无 batch 字段时再补充 `get summary`。只有明确要“最近我创建的听记 Markdown 汇总”时才用 `python3 scripts/minutes_recent_summary.py --max <N> --output summary.md` 3. 汇总展示;同一用户诉求下避免半截 list 或无必要的小批拆分 |
| minutes-detail | 1. 确定 `taskUuid`:用户已提供 → 直接用;未提供 → `minutes list mine --limit 5` 让用户选(**有时间线索时加 `--start`/`--end`**,如「上周五的会」→ `--start "2026-05-23T00:00:00+08:00" --end "2026-05-23T23:59:59+08:00"`) 2. 逐条串行拉取四维信息、由 AI 在内存合并结果(**禁止 `&` 并行 / `wait`**,见 minutes.md「错误处理」):`minutes get info --id <taskUuid>` → `minutes get summary --id <taskUuid>` → `minutes get keywords --id <taskUuid>` → `minutes get todos --id <taskUuid>` 3. 整合输出:基础信息(标题、时间、参与人)→ AI 摘要 → 关键字 → 行动项/待办 4. **展示发言人列表**:从转写/info 提取所有发言人(含已标注姓名和匿名编号),列出每位发言人的发言次数和时长占比,引导用户:「是否需要查看某位发言人的详细内容总结?请输入姓名或编号」→ 用户选定 → 进入 `minutes-speaker-summarize` recipe 5.(可选)用户要求看原文 → `minutes get transcription --id <taskUuid>` |
| minutes-speaker-summarize | 1. 读取转写 → `minutes get transcription --id <uuid>` 2. 声纹标注检查:已标注 → 跳 Step 6;匿名编号 → 继续 3. 转写原文推断(称呼/自我介绍/上下文指代)→ 高置信度跳 Step 6 4. 身份推断(逐条串行执行、由 AI 在内存合并结果,**禁止 `&` 并行 / `wait`**):`calendar event list` + `calendar attendee list` 取日程参与人(最高优先)→ `aisearch person` → `chat message list` → `doc search`;未找到同时段日程 → 引导用户提供日程链接或参会人名单;两路以上一致才下结论 5. 置信度分支与用户确认语义以 [minutes.md](../products/minutes.md)「发言人识别与总结执行链路」Step 5 为准(本文件不另设阈值) 6. 结构化总结输出(核心观点 + 问题 + Action Item + 立场)→ 追问是否替换发言人标注。详见 [10-minutes-speaker-match.md](./10-minutes-speaker-match.md) |
| speaker-correct | 1. **查同时段日程**:从听记元数据获取录音开始时间 → `calendar event list`(前后 30 分钟内)→ 若匹配到日程则提取参会人名单并展示 2. **展示发言人状态表格**:列出所有发言人及标注状态(已识别 / 未标注 / 未标注,发言较少) 3. **让用户选择识别方式**:听音识人(裁剪代表性音频片段让用户辨认)/ 手动设置(用户直接告知对应关系)/ 智能匹配(结合参会人名单和发言内容推断) 4. **执行替换**:确认对应关系后,通讯录查询获取 dingUid → `dws contact user search --query "<姓名>" --format json` → 取 userId(长整型)→ `dws minutes speaker replace --id <taskUuid> --from "发言人X" --to "<姓名>" --target-uid <userId> --format json`;多个匹配时列出候选让用户选;无匹配时执行不带 `--target-uid` 的替换 5. 替换成功后追问「还有其他发言人需要帮你识别和替换吗?」详见 [11-minutes-speaker-correct.md](./11-minutes-speaker-correct.md) |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |