Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-todo
wecomcli-todo
Verified何时用:仅当用户明确指向企业微信待办(建/查/改企微待办)时使用;泛指记个待办/提醒默认走本地工具,不要误用。企微待办:创建、删除或退出、完成、查询和筛选,以及修改标题、描述、参与人名单和截止时间。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.4 KB |
| references/todo-create.md | markdown | 8.6 KB |
| references/todo-delete.md | markdown | 2.8 KB |
| references/todo-finish.md | markdown | 3.9 KB |
| references/todo-get.md | markdown | 2.6 KB |
| references/todo-list.md | markdown | 8.8 KB |
| references/todo-update.md | markdown | 6.8 KB |
references/todo-finish.md
View on GitHub# 完成待办 — `wecom-cli todo finish`
将**当前用户**在该待办中的部分标记为"已完成"。如果当前用户同时是创建人,后台会返回 `ask_finish_all` 提示,可选择把所有参与人一并标记完成。
## 命令
```bash
wecom-cli todo finish --json '<JSON 参数>'
```
## 参数
外层为对象,待办放在 `items` 数组中:
| 字段 | 类型 | 必填 | 语义 |
|---|---|---|---|
| `items` | array | 是 | 待办数组,每项结构见下,单次最多 20 条;超出需分批 |
`items[]` 元素结构:
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
| `todo_id` | string | 是 | — | 待办 ID |
| `finished_all` | boolean | 否 | `false` | 创建人可设为 `true` 全部完成该待办。默认 `false` 仅完成自己的部分 |
示例入参:
```json
{
"items": [
{
"todo_id": "td_xxx",
"finished_all": false
}
]
}
```
## 返回
外层为对象,结果在 `items` 数组中,与入参 `items` 一一对应:
| 字段 | 类型 | 语义 |
|---|---|---|
| `items` | array | 完成结果数组 |
`items[]` 元素结构:
| 字段 | 类型 | 语义 |
|---|---|---|
| `success` | boolean | 是否完成成功 |
| `todo_id` | string | 待办 ID |
| `title` | string | 待办标题 |
| `ask_finish_all` | string | 当后台检测到用户既是创建人又是参与人时返回,提示模型询问用户是否标记为"全部完成" |
| `errmsg` | string | 失败原因,仅 `success=false` 时存在 |
## 使用规则
- **如果上下文没有对应待办 ID**:**必须**先阅读 `references/todo-list.md`,学习如何获取待办列表,在待办列表中找到需要完成的待办;此时应同时查 `finished` 和 `proceed`。如果已有 `todo_id` 但需要确认最新状态,使用 `wecom-cli todo get`。
- **完成操作要幂等**:定位待办时如果发现该待办整体 `status=finished` 或当前用户 `user_status=finished`,说明已完成,直接告知用户"这条待办已完成",不要再调用 `finish`。只有用户本次或本会话前文明确要求"完成后删除/清掉/自动删除"时,才继续按删除流程处理。
- 调用前先按用户语义决定 `finished_all`:
- 用户明确表达"仅我完成自己的部分"("我这边搞完了"、"我自己的部分先完成"、"先把我那块标了")→ **显式**传 `finished_all: false`。显式 false 才能让后端跳过 `ask_finish_all` 兜底,避免再次询问完成范围。
- 用户明确表达"全部完成"("完成了"、"这条结掉"、"都搞完了"),或本会话此前对同一个 `todo_id` 已经调过一次 `finished_all=false`、用户现在又一次说要完成它 → 传 `finished_all: true`。
- 表达不明确(只说"完成 XX 待办"、"把那条待办完成了",没有"仅我"或"全部"的语气)→ 不传 `finished_all`,让后端按下方 `ask_finish_all` 流程返回是否需要确认。
- **`ask_finish_all` 处理流程**:如果返回中出现 `ask_finish_all` 字段,说明当前用户是创建人,第一次调用已把当前用户自己的部分标记完成;**必须**用简洁自然语言向用户确认是否把其他参与人也一并标记完成,并在文字中列出「仅我完成」「已完全完成」两个选项。提问中应包含待办标题和 `followers` 中的参与人中文名(用顿号"、"拼接),例如:
```
待办「<待办标题>」中您的部分已完成。参与人:<参与人中文名>。请选择完成范围:仅我完成,还是已完全完成?
```
- 用户选 **「仅我完成」** → 不再调用接口(第一次已经完成了自己的部分),告知用户已标记完成。
- 用户选 **「已完全完成」** → 用同一个 `todo_id` 再次调用 `wecom-cli todo finish`,并传 `finished_all: true`。
- 结果 `items` 与入参 `items` 一一对应
- 禁止将 `todo_id`(待办 ID)展示给用户。
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 |