Sync: add productivity workflow notes

wiki/entities/Todoist.md

@@ -2,30 +2,38 @@
 title: "Todoist"
 type: entity
 tags: []
-sources: [multi-channel-assistant]
-last_updated: 2026-04-27
+last_updated: 2026-05-02
 ---
 
-## Aliases
-- Todoist
-- Todoist 应用
-- Todoist 任务管理
+## Overview
+Todoist 是一个流行的 SaaS 任务管理工具，提供 REST API v2，支持任务（Tasks）、评论（Comments）、项目（Projects）、分区（Sections）等对象的 CRUD 操作。
 
-## Definition
-Todoist 是一款跨平台（Web、iOS、Android、桌面）的个人待办事项管理应用，以简洁的界面和自然语言输入著称，是任务管理领域的标杆产品之一。
+## Role in Agent Workflows
+Todoist 常被用作 AI Agent 的外部状态同步层：
+- 创建/更新任务状态（In Progress / Waiting / Done）
+- 外化 Agent 的内部 Plan 到任务描述
+- 追加子步骤日志为评论
+- 接收 Cron Job 的逾期提醒通知
 
-## Key Characteristics
-- 自然语言输入：支持用自然语言快速创建任务（如"明天下午 3 点完成任务"）
-- 多平台同步：支持所有主流平台，数据实时同步
-- 项目层级：支持项目和子项目组织任务
-- 标签与过滤：支持标签和自定义过滤器进行任务筛选
-- 集成生态：支持与日历、邮件、云盘等多种工具集成
-- 协作功能：支持任务分配和评论（Premium 功能）
+## API Capabilities
+- **Tasks API**：创建、更新、移动、关闭任务
+- **Comments API**：在任务下追加评论
+- **Sections API**：创建分区组织任务（如 🟡 In Progress）
+- **Labels API**：为任务添加标签
+- **Projects API**：组织多个项目
 
-## Role in Task Management
-Todoist 代表了"独立任务管理工具"的理念——任务应与文档分离，各司其职。其竞品包括 Things、TickTick、Notion Tasks 等。与 Obsidian Tasks 插件不同，Todoist 采用独立界面而非嵌入式任务管理。
+## Integration Pattern
+典型集成方式（参考 [[TodoistTaskManager]]）：
+```bash
+./todoist_api.sh <endpoint> <method> [data_json]
+./sync_task.sh <content> <status> [task_id] [description] [labels]
+./add_comment.sh <task_id> <comment_text>
+```
 
-## Connections
-- [[ObsidianTasksPlugin]] ← replaces ← [[Todoist]]（作者用 Tasks 插件替代了 Todoist）
-- [[Obsidian]] ← alternative_task_tool ← [[Todoist]]（Obsidian Tasks 插件是 Todoist 的替代方案）
-- [[TaskAutomation]] ← uses ← [[Todoist]]（Agent 自动化任务添加场景）
+## Related Entities
+- [[TodoistRestApi]]：官方 REST API
+- [[OpenClawWorkspace]]：Agent 执行环境
+
+## Related Concepts
+- [[TaskVisibility]]
+- [[ExternalReasoning]]