59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
---
|
||
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]]
|