Skip to content

Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-todo

wecomcli-todo

Verified

何时用:仅当用户明确指向企业微信待办(建/查/改企微待办)时使用;泛指记个待办/提醒默认走本地工具,不要误用。企微待办:创建、删除或退出、完成、查询和筛选,以及修改标题、描述、参与人名单和截止时间。

FileKindSize
SKILL.mdskill md5.4 KB
references/todo-create.mdmarkdown8.6 KB
references/todo-delete.mdmarkdown2.8 KB
references/todo-finish.mdmarkdown3.9 KB
references/todo-get.mdmarkdown2.6 KB
references/todo-list.mdmarkdown8.8 KB
references/todo-update.mdmarkdown6.8 KB

references/todo-create.md

View on GitHub
# 创建待办 — `wecom-cli todo create`

以当前用户为发起人创建待办,可指定分派人并设置截止时间。

## 意图前置判断(在调用接口之前必须做)

"创建"类请求进入本技能前,先判断它是否真的属于待办:

- **消息里显式出现"待办"二字**(如"创建一条待办"、"添加待办"、"帮我记一个待办"、"把这事记到待办里")→ 在本技能内执行创建。
- **全局提醒路由已选"待办",或明确是"定时提醒的待办 / 待办提醒 / 创建待办并提醒"** → 在本技能内执行创建;若原话给出具体提醒时刻,则该时刻 = `deadline.type=datetime`,并传 `remind_at_deadline=true`;只给日期则可填 `deadline.type=date`,不追问且不传 `remind_at_deadline=true`;未给提醒/截止时间则不传 `deadline` / `remind_at_deadline`。
- **泛提醒但未明确要求创建企业微信待办** → 不要在本技能内擅自创建待办;先由上层路由确定承载方式。

## 命令

```bash
wecom-cli todo create --json '<JSON 参数>'
```

## 参数

外层为对象,待办放在 `items` 数组中:

| 字段 | 类型 | 必填 | 语义 |
|---|---|---|---|
| `items` | array | 是 | 待办数组,每项结构见下,支持批量,单次最多 20 条;超出需分批 |

`items[]` 元素结构:

| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
| `title` | string | 是 | — | 短标题,长度 >= 1 |
| `description` | string | 否 | — | 详细描述(可选的展开说明,不是标题)|
| `follower_ids` | string[] | 否 | `[]` | 分派人 userid 列表(前缀 `wo`),最多 50 人;用户给姓名时先通过 `wecomcli-contact` 技能查 `userid` |
| `deadline` | object | 否 | — | 截止时间。结构见 SKILL.md `deadline` 对象规范 |
| `remind_at_deadline` | boolean | 否 | `false` | 提醒时机,须与 `deadline` 同传:`true`=截止时刻提醒(仅 `datetime`);`false`/不传=按后台默认提前时间提醒(**非关闭提醒**)。脱离 `deadline` 单独传无效 |

`deadline` 整体可选;若提供则其内部 `type` 与 `value` 必填。

## 从用户消息推断字段

调用本命令前,按以下规则从用户原话里提取参数。除非真的提不出,**不要**用追问让用户重新说一遍——他刚才已经把事情讲清楚了,再问一次是劣体验。

### 推断 `title`(必填)

绝大多数情况下能从用户消息里提炼出标题。优先采用"动宾"结构,尽量保持用户的原始表达。当标题过长,非常细节的背景细节才放进 `description`。

**只有当用户消息里完全没有任何任务内容时**(例如只说"帮我记个待办"、"加一条待办",完全没讲事情本身),才向用户追问"要记什么事?"。哪怕只有一个动作或一个对象,也要先自己提炼,不要追问。

### 推断 `description`(可选,多数情况不传)

`description` 是**标题之外的补充说明**,只在用户给了标题装不下的额外细节(背景、要求、上下文)时才填写。

- **禁止把 `description` 写成与 `title` 相同或仅是 title 的复述**。如果提炼完标题后没有任何额外信息,就**不传** `description`——一条只有标题的待办是完全正常的,硬塞一个和标题一样的 description 属于冗余噪声。
- 用户用"内容是 / 就是 / 记一下 XX"等方式描述事情时,这通常就是在给**标题**,不是在额外补充描述:先把它提炼成 `title`;只有当它明显比标题多出独立信息时,多出来的部分才放进 `description`。
- 从当前会话上下文或待办查询结果批量创建待办时,不要只沿用概括标题;若上下文里已有明确的下一步动作、对接人、时间节点、链接或单号,应压缩写入 `description`。不确定的信息不要编造,也不要为了补全而反复追问。

### 推断 `follower_ids`

用户提到要分派给自己时(如"分派给我"、"我和 vincentwei 一起"),要把当前用户自己的 `userid` 也放进 `follower_ids`,因为后台不会自动把创建者算作分派人。但是如果是给我自己创建,没有其他参与人,就不用把我自己也放进去。

当用户表述中暗示某人与待办有参与或关联关系(如"与某人相关的待办""关于某人""和某人一起跟进"),应将关联人加入 `follower_ids`。

### 推断 `deadline` 与待办提醒

- `remind_at_deadline` 必须与 `deadline` 一起传,只用来选提醒时机("提前"还是"截止时");脱离 `deadline` 单独传无效。入参层面没有"关闭提醒"这一档,但是否真正提醒由后台判断,以返回的 `extra_info` 为准。
- 用户只说**截止时间/到期时间**,或给出任务发生日期时,填写 `deadline`,不要传 `remind_at_deadline`(即按后台默认提前时间提醒)。
- 用户明确要**提醒/到点提醒/截止时提醒/待办提醒**且给出具体时刻时,提醒时刻即 `deadline.type=datetime`,同时传 `remind_at_deadline=true`;只给日期时不传 `remind_at_deadline=true`。
- 用户说"xx 时间截止的待办,并提前 yy 提醒"时,`deadline` 永远填 **xx 截止时间**,不要填提前后的提醒时间。当前入参不能直接设置"提前 yy";创建后用返回的 `extra_info` 判断系统提醒时间是否刚好满足 yy。
- 未提任何与任务完成节点相关的时间时才不传 `deadline` / `remind_at_deadline`;不要追问,走默认参数。

`type` / `value` 的完整格式与示例见 SKILL.md `deadline` 对象规范。

## 示例入参

创建带截止时提醒的待办:

```json
{
  "items": [
    {
      "title": "准备周会材料",
      "description": "本周三上午周会需要的销售数据 PPT",
      "follower_ids": ["wo_xxx"],
      "deadline": {
        "type": "datetime",
        "value": "2026-05-13 09:00:00"
      },
      "remind_at_deadline": true
    }
  ]
}
```

## 返回

外层为对象,结果在 `items` 数组中,与入参 `items` 一一对应:

| 字段 | 类型 | 语义 |
|---|---|---|
| `items` | array | 创建结果数组 |

`items[]` 元素结构:

| 字段 | 类型 | 语义 |
|---|---|---|
| `success` | boolean | 此待办是否创建成功 |
| `todo_id` | string | 待办 ID(前缀 `td`),仅成功时返回 |
| `title` | string | 待办标题 |
| `followers` | array | 分派人列表,每项含 `userid` 和 `user_name`(格式 `英文名(中文名)`)|
| `extra_info` | string | 提醒时刻只读信息,可能不提醒 |
| `errmsg` | string | 单条创建失败原因,仅 `success=false` 时存在 |

## 给用户的反馈

### 回显创建结果

创建成功后,回复里要把这条待办回显给用户便于核对,**标题、参与人、截止时间**这三项都要体现(不存在的项缺省即可,不要硬写"无"):

- **标题**:取返回的 `title`。
- **参与人**:取返回 `followers[].user_name`,多人用 `、` 拼接;无分派人或仅创建者本人时缺省。只展示人名,不要出现 `userid`。
- **截止时间**:取**本次入参**的 `deadline.value`——返回体不回传 `deadline`,必须用刚提交的值;未设置截止时间时缺省。

批量创建时逐条回显。示例:

> 已创建待办「准备周会材料」,参与人:张三、李四,截止时间:2026-05-13 09:00:00。

### 提醒说明

创建成功且本次传了 `remind_at_deadline=true` 或用户提到提醒诉求时,**必须**在回显之后附上提醒说明(注意 `remind_at_deadline` 只对 datetime 生效):

- 用户要求"提前 X 提醒"时,核对 `extra_info` 是否为用户要求的提前提醒时间(即截止时间提前 X 后的时刻);匹配则说明已满足,不匹配或无 `extra_info` 则按固定话术说明:`目前不支持直接创建您需要的提醒时间,已为您设置截止时间为 XX,请到企业微信待办功能中手动修改提醒时间。`(XX 填本次 `deadline.value`)。
- 用户要求"截止时/到点提醒"时,只有 `deadline.type=datetime` 才应传 `remind_at_deadline=true`;若 `extra_info` 不等于 `deadline.value` 或缺失,仍需引导到企业微信待办功能中修改提醒时间。
- 返回里有 `extra_info`(且非"提前 X 提醒"场景)→ 引用 `extra_info` 里的时刻告诉用户届时会自动提醒。
- 返回里没有 `extra_info`(且非"提前 X 提醒"场景)→ 说明返回未确认提醒时间,引导用户到企业微信待办应用中检查/修改提醒时间。
- 不要另建定时任务来模拟待办提醒,避免重复提醒。

仅带 `deadline` 但未要求提醒的普通待办,无需额外提醒说明。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall