技能介绍

解决什么问题

跨设备待办管理常遇到数据分散问题：手机 App、网页版、命令行工具各自为政，任务状态无法同步，团队协作时更难统一查询。开发者需要在不同平台间手动复制粘贴，或编写胶水代码对接多个 API，效率低下且容易出错。

技能如何工作

1TodoS 通过统一的 REST API 解决上述问题。技能首先检测当前 shell 环境（bash/zsh 或 PowerShell），自动选择对应脚本目录中的 .sh 或 .ps1 文件。授权流程要求用户访问 https://mcptodo.kairusi.com/authorize，登录后获取 Token 和收件箱 UUID，分别保存到 ~/.config/1todos-skill/token 和 ~/.config/1todos-skill/inbox_uuid。

核心操作包括：

获取清单列表：按文件夹分组展示，显示每个清单的未完成任务数。
获取任务列表：默认返回未完成任务，可显示标题、截止日期和标签。
搜索任务：通过关键词匹配任务标题和标签。
创建任务：支持指定清单、截止日期和标签（需先获取标签 ID）。
完成任务：通过标题或 ID 标记任务为已完成。
标记星标：使用专用 todo/mark 接口，避免误用 todo/commit 导致的状态不生效问题。
删除任务：需用户确认后执行，防止误删。

适用边界与注意点

技能依赖外部 API 服务，需确保网络连接和有效 Token。Token 过期或未授权时，所有操作会停止并提示重新授权。收件箱 UUID 不在清单接口中返回，必须在授权时单独保存。星标操作必须使用专用接口，通过 todo/commit 更新标签会导致状态不生效。删除任务前会要求用户确认，避免误操作。