Auto-sync: 2026-04-21 16:03

wiki/entities/Todoist-Task-Manager.md

@@ -0,0 +1,58 @@
+---
+title: "Todoist Task Manager"
+type: entity
+tags: [AI Agent, Todoist, 任务管理, 可观测性]
+---
+
+## Aliases
+- Todoist Task Manager
+- todoist-task-manager
+
+## Definition
+
+Todoist Task Manager 是一个 AI Agent 任务可视化系统，通过 Todoist REST API 将 Agent 的内部推理和进度日志同步到 Todoist 任务看板，实现长时间运行任务的状态追踪和透明度提升。
+
+## Core Components
+
+### Bash Scripts
+
+| Script | 职责 |
+|--------|------|
+| `scripts/todoist_api.sh` | Todoist REST API 的 curl 封装，支持 GET/POST/PUT/DELETE |
+| `scripts/sync_task.sh` | 创建/更新任务，按 Section（In Progress/Waiting/Done）分类 |
+| `scripts/add_comment.sh` | 向任务追加评论，记录子步骤完成日志 |
+
+### Todoist Section Structure
+
+- `🟡 In Progress` — 正在执行的任务
+- `🟠 Waiting` — 等待中的任务
+- `🟢 Done` — 已完成的任务
+
+## Workflow
+
+1. Agent 接收到复杂任务 → 在 `In Progress` 创建任务，将 Plan 写入任务描述
+2. 每完成一个子步骤 → 调用 `add_comment.sh` 追加进度日志
+3. 任务完成 → 将任务移至 `Done` Section
+4. Heartbeat 脚本监控停滞任务并通知用户
+
+## Integration
+
+- **API**: Todoist REST API v2
+- **Agent**: OpenClaw（Agent 可自行创建和管理这些脚本）
+- **Visibility**: 外部化内部推理，提升用户对 Agent 行为的可观测性
+
+## Related Concepts
+
+- [[Agent-Task-Visibility]]
+- [[Task-Automation]]
+- [[工作流自动化]]
+- [[Todoist]]
+
+## Related Entities
+
+- [[OpenClaw]]
+- [[Todoist]]
+
+## Source
+
+- [[sources/todoist-task-manager-agent-task-visibility]]