wecomcli-get-todo-list

Q: How do I install wecomcli-get-todo-list?

Run npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-get-todo-list in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wecomcli-get-todo-list/ (personal) or .claude/skills/wecomcli-get-todo-list/ (project).

by wecomteamProductivity & Automation

企业微信待办列表查询技能，支持按创建时间和提醒时间过滤，支持分页。在用户说"看看我的待办列表"、"我有哪些待办"、"这周的待办有哪些"、"最近有什么待办"、"查一下我的待办"、"列出所有待办"等需要浏览待办概览的场景时使用。注意：此技能仅返回待办概要信息（不含内容和分派人），如需完整详情请配合 wecomcli-get-todo-detail 使用。

Installs: 2.4K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-get-todo-list

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads wecomcli-get-todo-list automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

企业微信待办列表查询技能

wecom-cli 是企业微信提供的命令行程序，所有操作通过执行 wecom-cli 命令完成。

通过 wecom-cli 查询企业微信待办列表，支持按时间过滤和分页。

行为策略

查完列表必须查详情: 本接口只返回待办 ID 和状态等概要信息，不包含待办的实际内容和分派人。对用户来说，没有内容的待办列表毫无用处——他们想知道的是"要做什么"，而不是一串 ID。因此，每次调用 get_todo_list 拿到结果后，都要紧接着用返回的 todo_id 列表调用 wecomcli-get-todo-detail 获取完整详情（内容、分派人等），然后再向用户展示。这不是可选步骤，而是完成用户请求的必要环节。

分页未拉完时必须提醒用户: 接口是分页的，不要求一次性拉完所有数据。但如果响应中 has_more 为 true，说明后面还有待办没有返回——这时你在展示当前结果的同时，必须明确告诉用户"还有更多待办未显示，是否需要继续查看？"。用户可能不知道后面还有数据，如果你不说，他们会以为看到的就是全部，这会导致遗漏重要待办。这是一个容易被忽略但后果严重的点，请务必执行。

重试策略: 遭遇"返回 HTTP 错误"或"HTTP 请求失败"时，主动重试，最多重试三次。

调用方式

wecom-cli todo get_todo_list '<json格式的入参>'

参数说明

参数	类型	必填	说明
`create_begin_time`	string	❌	创建开始时间，格式：`YYYY-MM-DD HH:mm:ss`
`create_end_time`	string	❌	创建结束时间，格式：`YYYY-MM-DD HH:mm:ss`
`remind_begin_time`	string	❌	提醒开始时间，格式：`YYYY-MM-DD HH:mm:ss`
`remind_end_time`	string	❌	提醒结束时间，格式：`YYYY-MM-DD HH:mm:ss`
`limit`	number	❌	最大返回数量，默认 10，最大 20
`cursor`	string	❌	分页游标，首次请求不传，后续传入上次响应的 `next_cursor`

返回格式

{
    "errcode": 0,
    "errmsg": "ok",
    "index_list": [
        {
            "todo_id": "TODO_ID",
            "todo_status": 1,
            "user_status": 1,
            "creator_id": "CREATOR_ID",
            "remind_time": "2025-06-01 09:00:00",
            "create_time": "2025-01-15 10:30:00",
            "update_time": "2025-01-16 14:20:00"
        }
    ],
    "next_cursor": "NEXT_CURSOR",
    "has_more": false
}

返回字段说明

字段	类型	说明
`index_list`	array	待办列表
`index_list[].todo_id`	string	待办唯一 ID
`index_list[].todo_status`	number	待办状态：`0`-已完成，`1`-进行中，`2`-已删除
`index_list[].user_status`	number	用户状态：`0`-拒绝，`1`-接受，`2`-已完成
`index_list[].creator_id`	string	创建人 ID
`index_list[].remind_time`	string	提醒时间
`index_list[].create_time`	string	创建时间
`index_list[].update_time`	string	更新时间
`next_cursor`	string	下一页游标
`has_more`	boolean	是否还有更多记录

列表返回的是待办概要信息（不含内容和分派人）。拿到列表后，必须调用 wecomcli-get-todo-detail 获取完整详情再展示给用户。

典型工作流

查看待办列表（标准两步流程）

用户问："看看我最近的待办" / "我有哪些待办事项？" / "我还有多少事要做？"

第一步：获取待办列表（只有 ID 和状态，没有内容）。

wecom-cli todo get_todo_list '{}'

第二步（禁止跳过！）：用返回的 todo_id 列表调用 wecomcli-get-todo-detail 获取完整详情。

wecom-cli todo get_todo_detail '{"todo_id_list": ["返回的TODO_ID_1", "返回的TODO_ID_2"]}'

两步缺一不可——只有拿到详情后，才能向用户展示有意义的待办内容。

第三步（条件执行）：检查第一步返回的 has_more 字段。如果为 true，在展示结果时必须提醒用户："以上是部分待办，还有更多待办未显示，需要我继续查看吗？"——不提醒的话，用户会以为这就是全部。

按时间范围查询

用户问："这个月创建的待办有哪些？"

wecom-cli todo get_todo_list '{"create_begin_time": "2025-03-01 00:00:00", "create_end_time": "2025-03-31 23:59:59"}'

分页获取大量待办

当待办数量超过单页上限时，通过 cursor 循环分页拉取：

首次请求（不传 cursor）：

wecom-cli todo get_todo_list '{"limit": 20}'

，如果没有拉取完，还有更多的待办，会返回 has_more=true, next_cursor="CURSOR_1"

第二次请求（传入上次的 next_cursor）：

wecom-cli todo get_todo_list '{"limit": 20, "cursor": "CURSOR_1"}'

，返回 has_more=false，拉取完毕

分页规则：

首次请求不传 cursor
has_more 为 true 时，将 next_cursor 作为下次请求的 cursor 传入
has_more 为 false 时停止请求
分页过程中时间过滤参数保持不变
如果选择不继续翻页（比如当前页数据已经够用），必须告诉用户还有更多待办未显示，问用户是否需要继续查看

注意事项

时间格式：所有时间参数使用 YYYY-MM-DD HH:mm:ss 格式，用户说"明天"、"下周一"等相对时间时，根据当前日期推算具体日期
状态值含义
- 待办状态（todo_status）：0-已完成，1-进行中，2-已删除
- 用户状态（user_status）：0-拒绝，1-接受，2-已完成
错误处理：若 errcode 不为 0，告知用户 errmsg 中的错误信息
必须查详情：本接口返回的是概要信息（不含内容和分派人），拿到列表后必须紧接着调用 wecomcli-get-todo-detail 获取完整内容再展示给用户，不要只展示列表概要
分页未拉完必须提醒：如果返回的 has_more 为 true，在向用户展示结果时必须明确说明"还有更多待办未显示"并询问用户是否需要继续查看。用户不知道后面还有数据，不提醒会导致遗漏

FAQ

What does the wecomcli-get-todo-list skill do?

How do I install wecomcli-get-todo-list?

Run npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-get-todo-list in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wecomcli-get-todo-list/ (personal) or .claude/skills/wecomcli-get-todo-list/ (project).

Which AI agents can use wecomcli-get-todo-list?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is wecomcli-get-todo-list safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains wecomcli-get-todo-list?

It is published by wecomteam in wecomteam/wecom-cli. It has 2,415 recorded installs.

More from wecomteam/wecom-cli

View all →

wecomcli-doc

wecomteam/wecom-cli

企业微信在线 doc 文档技能。能够新建 doc、导入本地 .doc/.docx/.txt 为 doc、读取 doc 内容、向 doc 追加或覆盖写入。仅当用户明确出现「doc」「docx」「word」「在线文档」「office 文档」等强类型词，或提供 https://doc.weixin.qq.com/doc/xxx 链接时才使用本技能。用户说"文档""新建文档""写文档""整理成文档""输出到文档"等未指定类型的泛化表达，一律使用 wecomcli-smartpage。

Docs & Writing24.4K installs

wecomcli-todo

wecomteam/wecom-cli

管理企业微信待办，支持创建、删除或退出、完成、查询和筛选，以及修改标题、描述、参与人名单和截止时间。

Productivity & Automation24.2K installs

wecomcli-meeting

wecomteam/wecom-cli

企业微信会议管理。本技能负责『在线会议』——即含在线会议链接（含会议号/入会链接、可远程或视频参会）的会议的创建、查询、搜索、获取详情（含会议信息、纪要、待办）、查询会议转写原文（逐字发言记录）、更新、取消等全部操作；若用户要的是不含在线会议链接的『日程』（也涵盖纯线下面对面碰头），改用 wecomcli-calendar 技能。用户仅说'开会/约个会/某会/某会议'等、未明确要创建的是日程还是在线会议时，必须先读取本技能并按其中的消歧流程向用户追问确认后再处理，不可臆断直接创建。

Productivity & Automation24.1K installs

wecomcli-contact

wecomteam/wecom-cli

使用 wecom-cli 按姓名、拼音、英文名或别名搜索企业微信通讯录中的人员，并查询匹配人员的 userid、部门和职务。适用于查找联系人、区分同名人员、获取用户 userid，以及列出全部同名人员。

24.1K installs

wecomcli-smartsheet

wecomteam/wecom-cli

企业微信智能表格内容操作技能——专注于智能表格（smartsheet）的数据、结构与样式管理：读取表结构与记录、管理子表/字段/记录/视图/图表，以及修改行列样式（填色/高亮）；记录新增或更新遇到 851003 / no authority 时通过 Webhook 兜底写入。触发条件：用户提到智能表格、企微表格、smartsheet 的内容操作或样式修改，或链接形如 https://doc.weixin.qq.com/smartsheet/s3xxx。企业微信表格分为「智能表格」和「在线表格」两种类型，本文档介绍的是智能表格的相关技能。智能表格包含子表（sheet）、视图（view）、字段/列（field），每条记录（record）以 recordid 作为主键，结构类似关系型数据库。当用户未明确说明使用「在线表格」时，一律默认使用功能更强大的智能表格（本技能）。

Backend & APIs19.5K installs

wecomcli-msg

wecomteam/wecom-cli

企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。

16.4K installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs

wecomcli-get-todo-list

Install

Install

Describe the task

Review the result

SKILL.md

企业微信待办列表查询技能

行为策略

调用方式

参数说明

返回格式

返回字段说明

典型工作流

查看待办列表（标准两步流程）

按时间范围查询

分页获取大量待办

注意事项

FAQ

More from wecomteam/wecom-cli

Popular productivity & automation skills