Skip to content

todoist-task-manager.md

Latest commit

 

History

History
131 lines (102 loc) · 4.6 KB

todoist-task-manager.md

File metadata and controls

131 lines (102 loc) · 4.6 KB
Raw

Todoist 任务管理器：智能体任务可见性

通过将内部推理和进度日志直接同步到 Todoist，最大化长时间运行的智能体工作流的透明度。

痛点

当智能体运行复杂的多步骤任务（如构建全栈应用或进行深度研究）时，用户经常无法追踪智能体当前在做什么、哪些步骤已完成、以及智能体可能在哪里卡住。对于后台任务，手动检查聊天日志非常繁琐。

功能介绍

这个用例使用 todoist-task-manager 技能来：

  1. 可视化状态：在特定分区创建任务，如 🟡 进行中 或 🟠 等待中。
  2. 外化推理：将智能体的内部"计划"发布到任务描述中。
  3. 流式日志：将子步骤完成情况作为评论实时添加到任务中。
  4. 自动校验：心跳脚本（heartbeat script）检查停滞的任务并通知用户。

所需技能

你不需要预构建的技能。只需提示你的 OpenClaw 智能体创建下面设置指南中描述的 bash 脚本。由于 OpenClaw 可以管理自己的文件系统并执行 shell 命令，它会按你的要求"构建"这个技能。

详细设置指南

1. 配置 Todoist

创建一个项目（例如 "OpenClaw Workspace"）并获取其 ID。为不同状态创建分区：

  • 🟡 In Progress（进行中）
  • 🟠 Waiting（等待中）
  • 🟢 Done（已完成）

2. 实现："智能体自建"技能

你可以让 OpenClaw 为你创建这些脚本，而不是安装技能。每个脚本处理与 Todoist API 通信的不同部分。

scripts/todoist_api.sh（核心封装脚本）：

#!/bin/bash
# 用法：./todoist_api.sh <endpoint> <method> [data_json]
ENDPOINT=$1
METHOD=$2
DATA=$3
TOKEN="YOUR_TODOIST_API_TOKEN"

if [ -z "$DATA" ]; then
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN"
else
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "$DATA"
fi

scripts/sync_task.sh（任务和状态管理）：

#!/bin/bash
# 用法：./sync_task.sh <task_content> <status> [task_id] [description] [labels_json_array]
CONTENT=$1
STATUS=$2
TASK_ID=$3
DESCRIPTION=$4
LABELS=$5
PROJECT_ID="YOUR_PROJECT_ID"

case $STATUS in
  "In Progress") SECTION_ID="SECTION_ID_PROGRESS" ;;
  "Waiting")     SECTION_ID="SECTION_ID_WAITING" ;;
  "Done")        SECTION_ID="SECTION_ID_DONE" ;;
  *)             SECTION_ID="" ;;
esac

PAYLOAD="{\"content\": \"$CONTENT\""
[ -n "$SECTION_ID" ] && PAYLOAD="$PAYLOAD, \"section_id\": \"$SECTION_ID\""
[ -n "$PROJECT_ID" ] && [ -z "$TASK_ID" ] && PAYLOAD="$PAYLOAD, \"project_id\": \"$PROJECT_ID\""
if [ -n "$DESCRIPTION" ]; then
  # 转义描述中的换行符和引号
  ESC_DESC=$(echo "$DESCRIPTION" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
  PAYLOAD="$PAYLOAD, \"description\": \"$ESC_DESC\""
fi
[ -n "$LABELS" ] && PAYLOAD="$PAYLOAD, \"labels\": $LABELS"
PAYLOAD="$PAYLOAD}"

if [ -n "$TASK_ID" ]; then
  ./scripts/todoist_api.sh "tasks/$TASK_ID" POST "$PAYLOAD"
else
  ./scripts/todoist_api.sh "tasks" POST "$PAYLOAD"
fi

scripts/add_comment.sh（进度日志记录）：

#!/bin/bash
# 用法：./add_comment.sh <task_id> <comment_text>
TASK_ID=$1
TEXT=$2
# 转义文本中的换行符和引号
ESC_TEXT=$(echo "$TEXT" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
PAYLOAD="{\"task_id\": \"$TASK_ID\", \"content\": \"$ESC_TEXT\"}"
./scripts/todoist_api.sh "comments" POST "$PAYLOAD"

3. 使用提示词

你可以将以下提示词交给你的智能体，用于设置和使用任务可见性系统：

I want you to build a Todoist-based task visibility system for your own runs.

First, create three bash scripts in a 'scripts/' folder:
1. todoist_api.sh (a curl wrapper for Todoist REST API)
2. sync_task.sh (to create or update tasks with specific section_ids for In Progress, Waiting, and Done)
3. add_comment.sh (to post progress logs as comments)

Use these variables for the setup:
- Token: [Your Todoist API Token]
- Project ID: [Your Project ID]
- Section IDs: [In Progress ID, Waiting ID, Done ID]

Once created, for every complex task I give you:
1. Create a task in 'In Progress' with your full PLAN in the description.
2. For every sub-step completion, call add_comment.sh with a log of what you did.
3. Move the task to 'Done' when finished.

相关链接

原文链接：English Version